Перейти к содержимому
LegalStack
APIБезопасность и доступАгенты

Создать агента

Создаёт агента с выбранной персоной. Создатель становится владельцем агента. Создавать агентов могут владелец и администраторы команды, а также сотрудники с правом на создание в модуле «Агенты».

POST/api/v1/security/agents

Авторизация

AuthorizationBearer <токен>

Access token, привязанный к ключу клиента по RFC 9449: заголовок Authorization: DPoP <token> и заголовок DPoP с доказательством для каждого запроса. Сервер выдаёт DPoP-Nonce, который клиент включает в доказательство.

Передаётся в: header

Параметры заголовков

idempotency-key?string

Ключ идемпотентности для безопасного повтора запроса: 8–255 символов из набора A-Za-z0-9_.:+/=-, ответ кэшируется на 24 ч

Совпадение^[A-Za-z0-9_.:+/=-]{8,255}$
Длина8 <= length <= 255

Тело запроса

application/json

TypeScript-определения

Используйте тип request body в TypeScript.

Тело ответа

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/api/v1/security/agents" \  -H "Authorization: Bearer <access_token>" \  -H "Content-Type: application/json" \  -d '{    "audience": "team",    "name": "string",    "preset": "paralegal"  }'
{  "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}

GETАгенты команды

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

DELETEУдалить агента

Удаляет агента вместе с личной памятью, файлами и заданиями сотрудников у этого агента. Основного агента команды удалить нельзя. Доступно владельцу агента и администраторам команды.