Контекст агента

Контекст агента сообщает аудитам, для чего существует каждый агент, что он должен производить и что он никогда не должен делать. Failproof AI хранит этот контекст как один контракт агента на агента. Контекст агента принадлежит организации, а не одному аудиту. Вы описываете его один раз на агента, и каждый аудит на основе модели, область охвата которого включает этого агента, использует его.

Добавить контекст агента

Dashboard
CLI

Перейдите в Analyze → audits, выберите agents и выберите идентификатор агента, указанный в его сеансах.
Выберите add content или edit.
Опишите назначение агента, что он должен производить, что означает «готово», как часто он должен работать и что он никогда не должен делать.
Сохраните контекст, затем вернитесь в форму аудита и подтвердите, что выбранный агент отображается как охвачённый.

Вы также можете добавить или отредактировать контекст агента из ящика agents во время создания или редактирования аудита. Это сохраняется независимо и сразу же становится доступным для каждого применимого аудита.

Cloud CLI пока не предоставляет команды контракта. Используйте публичный API с ключом, несущим audits:read и audits:write:

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."
  }'

Список контрактов с GET /v1/audits/contracts; получить один контракт с GET /v1/audits/contracts/{id}. Обновление с помощью PUT полностью заменяет ресурс и требует как agent_id, так и body.

Напишите полезный контекст

Держите контекст под 5000 символов и сделайте его проверяемым. Полезный контекст обычно содержит:

Purpose: почему существует агент
Outputs: артефакты или действия, которые он должен производить
Done when: условие, которое делает выполнение успешным
Cadence: как часто или когда он должен работать
Must not: действия и результаты, которые всегда неприемлемы

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

Контекст агента описывает ожидаемое поведение; он не может сказать анализу, к какому выводу прийти или ограничить, какие доказательства он должен изучать. Агенты без контекста аудируются нормально, но Failproof AI не может судить об их поведении в соответствии с организационными намерениями.

Приостановить или изменить контекст агента

Приостановите контекст агента, когда аудиты должны временно его игнорировать. Приостановка обратима.
Отредактируйте контекст, когда изменяется ответственность агента. Новый текст применяется к будущим выполнениям.
Проверьте last matched, когда работающий агент, похоже, никогда не использует свой контекст. Обычно это означает, что его идентификатор агента не совпадает с телеметрией.
Удалить через API только когда текст должен быть окончательно уничтожен. Панель управления намеренно предлагает приостановку вместо удаления.

Каждый запуск аудита сохраняет точный снимок контекста агента, который он использовал. Редактирование, приостановка или удаление текущего ресурса контракта не переписывает основание более ранних выводов.

Чтение контрактов требует audits:read. Их создание, редактирование, приостановка или удаление требует audits:write.

​Добавить контекст агента

​Напишите полезный контекст

​Приостановить или изменить контекст агента

Добавить контекст агента

Напишите полезный контекст

Приостановить или изменить контекст агента