Agent konteksti - Failproof AI

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

Kontrol Paneli
CLI

Analiz → denetimler’e gidin, ajanları seçin ve oturumlarından bildirilen ajan kimliğini seçin.
İçerik ekle veya düzenle’yi seçin.
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.
Konteksti kaydedin, sonra denetim formuna dönün ve seçilen ajanın kapsanmış olarak gösterildiğini doğrulayın.

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.

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:

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.

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

---
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.

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

​Agent konteksti ekleme

​Yararlı kontekst yazma

​Agent kontekstini duraklatma veya değiştirme

Agent konteksti ekleme

Yararlı kontekst yazma

Agent kontekstini duraklatma veya değiştirme