> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent konteksti

> Denetimlere her ajanın ne yapması, ne üretmesi ve asla ne yapmaması gerektiğini söyleyin.

Agent konteksti denetimlere her ajanın ne için var olduğunu, ne üretmesi gerektiğini ve ne yapmaması gerektiğini söyler. Failproof AI bu konteksti ajan başına bir ajan sözleşmesi olarak depolar.

Agent konteksti kuruluşa aittir, tek bir denetimi değil. Bunu ajan başına bir kez yazarsınız ve kapsamı o ajana dahil olan her model destekli denetim bunu kullanır.

## Agent konteksti ekleme

<Tabs>
  <Tab title="Kontrol Paneli">
    1. **Analiz → denetimler**'e gidin, **ajanlar**ı seçin ve oturumlarından bildirilen ajan kimliğini seçin.
    2. **İçerik ekle** veya **düzenle**'yi seçin.
    3. Ajanın ne için olduğunu, ne üretmesi gerektiğini, "tamamlandı"nın ne anlama geldiğini, ne sıklıkta çalışması gerektiğini ve asla ne yapmaması gerektiğini açıklayın.
    4. Konteksti kaydedin, sonra denetim formuna dönün ve seçilen ajanın kapsanmış olarak gösterildiğini doğrulayın.

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/agent-context.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=436caf4d808650059cc3a3edd1c11b38" alt="Bir ajan için amaç, çalışma sıklığı, çıktılar, tamamlanma koşulları ve yasaklı davranışları eklemek için kullanılan denetim Ajanları çekmecesi." width="2416" height="1600" data-path="images/dashboard/agent-context.png" />

    Denetim oluştururken veya düzenlerken **ajanlar** çekmecesinden agent konteksti ekleyebilir veya düzenleyebilirsiniz. Bağımsız olarak kaydedilir ve hemen her uygulanabilir denetim için kullanılabilir.
  </Tab>

  <Tab title="CLI">
    Cloud CLI henüz sözleşme komutlarını göstermemektedir. `audits:read` ve `audits:write` taşıyan bir anahtarla genel API'yi kullanın:

    ```bash theme={null}
    curl -X POST "https://app.befailproof.ai/v1/audits/contracts" \
      -H "Authorization: Bearer $FAILPROOFAI_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "agent_id": "nightly-reconciler",
        "enabled": true,
        "body": "# Purpose\nReconcile yesterday's payouts.\n\n## Outputs\nPublish a signed summary.\n\n## Must not\nNever modify ledger entries."
      }'
    ```

    Sözleşmeleri `GET /v1/audits/contracts` ile listeleyin; tek bir sözleşmeyi `GET /v1/audits/contracts/{id}` ile alın. `PUT` ile güncelleme tam bir değişikliktir ve hem `agent_id` hem de `body` gerektirir.
  </Tab>
</Tabs>

## Yararlı kontekst yazma

Konteksti 5.000 karakterin altında tutun ve test edilebilir yapın. Yararlı kontekst normalde aşağıdakileri içerir:

* **Amaç:** ajanın neden var olduğu
* **Çıktılar:** üretmesi gereken yapıtlar veya eylemler
* **Tamamlandı şu zaman:** bir çalışmayı başarılı kılan koşul
* **Çalışma sıklığı:** ne sıklıkta veya ne zaman çalışması gerektiği
* **Yapmaması gereken:** her zaman kabul edilemez eylemler ve sonuçlar

```markdown theme={null}
---
agent: nightly-reconciler
purpose: Reconcile yesterday's payouts and publish a signed summary.
cadence: Once daily after 02:00 UTC. Never more than once.
---

## Outputs
- A signed reconciliation summary in the finance channel.

## Done when
- Every payout is matched or explicitly flagged.

## Must not
- Modify ledger entries. Report discrepancies instead.
```

Agent konteksti beklenen davranışı belirtir; analizi sonuca ne ulaşması gerektiğini söyleyemez veya hangi kanıtları inceleyeceğini kısıtlayamaz. Konteksti olmayan ajanlar normalde denetlenir, ancak Failproof AI davranışlarını kuruluşa özgü niyet ile yargılayamaz.

## Agent kontekstini duraklatma veya değiştirme

* Denetimler geçici olarak bunu yoksayması gerektiğinde agent kontekstini duraklatın. Duraklatma tersine çevrilebilir.
* Ajanın sorumluluğu değiştiğinde konteksti düzenleyin. Yeni metin gelecek çalışmalara uygulanır.
* Çalışan bir ajan hiçbir zaman kontekstini kullanmıyor gibi görünüyorsa **son eşleşme** kontrolü yapın. Bu genellikle ajan kimliğinin telemetri ile eşleşmediği anlamına gelir.
* Metin kalıcı olarak silinmesi gerektiğinde API aracılığıyla silin. Kontrol paneli kasıtlı olarak silme yerine duraklatmayı sunar.

Her denetim çalışması, kullanılan tam agent-kontekst anlık görüntüsünü depolar. Geçerli sözleşme kaynağını düzenlemek, duraklatmak veya silmek, önceki bulguların temelini yeniden yazmaz.

<Info>
  Sözleşmeleri okumak `audits:read` gerektirir. Bunları oluşturmak, düzenlemek, duraklatmak veya silmek `audits:write` gerektirir.
</Info>