Сделать агента основным
Основной агент отвечает в чате по умолчанию, его нельзя удалить или приостановить. Прежний основной агент становится обычным. Если агент открыт не всей команде, доступ команде выдаётся автоматически. Приостановленного агента сделать основным нельзя. Доступно владельцу и администраторам команды.
/api/v1/security/agents/{agentId}/defaultAccess token, привязанный к ключу клиента по RFC 9449: заголовок Authorization: DPoP <token> и заголовок DPoP с доказательством для каждого запроса. Сервер выдаёт DPoP-Nonce, который клиент включает в доказательство.
Передаётся в: header
Параметры пути
Идентификатор агента
uuidПараметры заголовков
Ключ идемпотентности для безопасного повтора запроса: 8–255 символов из набора A-Za-z0-9_.:+/=-, ответ кэшируется на 24 ч
^[A-Za-z0-9_.:+/=-]{8,255}$8 <= length <= 255Тело ответа
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/api/v1/security/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/default" \ -H "Authorization: Bearer <access_token>"{ "config": { "avatar": "ball", "capabilities": { "browser": true, "web": true }, "instructions": "string", "preset": "paralegal", "sources": [ { "id": "string", "kind": "knowledge", "title": "string" } ], "tools": { "domains": { "раздел1": "allow", "раздел2": "allow" }, "effects": { "irreversible": "allow", "read": "allow", "write": "allow" }, "tools": { "раздел.действие1": "allow", "раздел.действие2": "allow" } } }, "createdAt": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "isDefault": true, "name": "string", "permissions": { "canEdit": true, "canManage": true, "canSchedule": true, "canUse": true }, "status": "active", "suspendReason": "string", "suspendedAt": "string", "suspendedBy": "cf641c27-1df2-43ad-8d4f-fa89421349da", "updatedAt": "string", "version": 0}PATCHИзменить агента
Каждое изменение имени или настроек сохраняется новой версией. Заголовок If-Match с текущей версией обязателен: если агента уже изменили, запрос отклоняется с кодом 412.
POSTВозобновить работу агента
Агент снова может работать: задания по расписанию, остановленные приостановкой, включаются. Задачи, переданные людям, остаются у них.