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

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

export default function Layout(props) {
  const { OpenAPIPage } = props.components ?? {};
  return (
    <>
      {props.children}
      ## Агенты команды

`GET /api/v1/security/agents`

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

**Авторизация:** dpop или oauth2: `security.teams:read`, `security.teams:write`

**Ответы**

- `200` — Агенты команды (`application/json`, AgentList)
  - `agents`: массив Agent, обязательное — Агенты, которыми может пользоваться текущий пользователь
    - `config`: AgentConfig, обязательное
      - `avatar`: "ball" | "triangle" | "square" | "star" | "asterisk" | "corner" | null, обязательное — Аватар своего агента; null — аватар пресета
      - `capabilities`: object, обязательное
      - `instructions`: string, обязательное — Дополнительные инструкции агенту
      - `preset`: "paralegal" | "civilist" | "litigator" | "investigator" | "compliance" | "legal-engineer" | "custom", обязательное — Персона агента
      - `sources`: массив AgentSource, обязательное — Материалы команды, на которые агент опирается
      - `tools`: AgentToolPolicy, обязательное — Права агента на инструменты
    - `createdAt`: string, обязательное — Когда агент создан, ISO 8601
    - `id`: string (uuid), обязательное
    - `isDefault`: boolean, обязательное — Агент команды по умолчанию
    - `name`: string, обязательное — Имя агента
    - `permissions`: AgentPermissions, обязательное
      - `canEdit`: boolean, обязательное — Настраивает агента: персону, инструкции, возможности, подтверждения
      - `canManage`: boolean, обязательное — Управляет доступом к агенту
      - `canSchedule`: boolean, обязательное — Ставит агенту задачи по расписанию
      - `canUse`: boolean, обязательное — Пользуется агентом
    - `status`: "active" | "suspended", обязательное — active — агент работает; suspended — приостановлен
    - `suspendReason`: string, nullable, обязательное — Причина приостановки
    - `suspendedAt`: string, nullable, обязательное — Когда агент приостановлен, ISO 8601
    - `suspendedBy`: string (uuid), nullable, обязательное — Кто приостановил агента
    - `updatedAt`: string, обязательное — Когда настройки агента менялись в последний раз, ISO 8601
    - `version`: integer, обязательное — Номер текущей версии настроек
  - `canCreate`: boolean, обязательное — Может ли текущий пользователь создавать агентов
- `401` — Токен отсутствует, недействителен или истёк (`application/problem+json`, ProblemDetails)
- `403` — Недостаточно прав или scope (`application/problem+json`, ProblemDetails)
- `429` — Превышен лимит запросов, повторите через Retry-After секунд (`application/problem+json`, ProblemDetails)

    </>
  );
}