Определение вашего агента

Агент — это переиспользуемая версионированная конфигурация, которая определяет персону и возможности. Она объединяет модель, системную подсказку, инструменты, серверы MCP и навыки, которые формируют поведение Claude во время сессии.

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



Поля конфигурации агента

Вы также можете переопределить model, system, tools, mcp_servers и skills для отдельной сессии, не изменяя самого агента. См. Переопределение конфигурации агента для сессии.



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

Следующий пример определяет агента для программирования, который использует Claude Opus 4.8 с доступом к готовому набору инструментов агента. Этот набор инструментов позволяет агенту писать код, читать файлы, выполнять поиск в интернете и многое другое. Полный список поддерживаемых инструментов см. в справочнике по инструментам агента.

В примерах используется curl, CLI ant или один из SDK. Если вы ещё не настроили их, в кратком руководстве описаны установка и настройка клиента.

agent=$(ant beta:agents create \
  --name "Coding Assistant" \
  --model '{id: claude-opus-4-8}' \
  --system "You are a helpful coding agent." \
  --tool '{type: agent_toolset_20260401}' \
  --format json)

AGENT_ID=$(jq -r '.id' <<< "$agent")
AGENT_VERSION=$(jq -r '.version' <<< "$agent")

Ответ повторяет вашу конфигурацию и добавляет поля id, type, version, created_at, updated_at и archived_at. Значение version начинается с 1 и увеличивается каждый раз, когда обновление изменяет агента.

{
  "id": "agent_01HqR2k7vXbZ9mNpL3wYcT8f",
  "type": "agent",
  "name": "Coding Assistant",
  "model": {
    "id": "claude-opus-4-8",
    "speed": "standard"
  },
  "system": "You are a helpful coding agent.",
  "description": null,
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "default_config": {
        "permission_policy": { "type": "always_allow" }
      }
    }
  ],
  "skills": [],
  "mcp_servers": [],
  "metadata": {},
  "version": 1,
  "created_at": "2026-04-03T18:24:10.412Z",
  "updated_at": "2026-04-03T18:24:10.412Z",
  "archived_at": null
}

Поле default_config в наборе инструментов показывает его политику разрешений по умолчанию — always_allow, которая применяется, если вы не настроили другую.



Обновление агента

Обновление агента создаёт новую версию, когда конфигурация изменяется. Поле version является обязательным и должно совпадать с текущей версией агента, чтобы вы всегда обновляли агента из известного состояния. Несовпадение версий возвращает ошибку 409, а обновления архивированных агентов отклоняются.

ant beta:agents update \
  --agent-id "$AGENT_ID" \
  --version "$AGENT_VERSION" \
  --system "You are a helpful coding agent. Always write tests."



Семантика обновления

• Пропущенные поля сохраняются. Вам нужно включать только те поля, которые вы хотите изменить.

• Скалярные поля (model, system, name, description) заменяются новым значением. Поля system и description можно очистить, передав null. Поля model и name являются обязательными и не могут быть очищены.

• Поля-массивы (tools, mcp_servers, skills) полностью заменяются новым массивом. Чтобы полностью очистить поле-массив, передайте null или пустой массив.

• multiagent заменяется целиком, включая его список agents. Передайте null, чтобы очистить его.

• Метаданные объединяются на уровне ключей. Предоставленные вами ключи добавляются или обновляются. Пропущенные вами ключи сохраняются. Чтобы удалить конкретный ключ, установите его значение в null.

• Обнаружение отсутствия изменений. Если обновление не приводит к изменениям относительно текущей версии, новая версия не создаётся, и возвращается существующая версия.

• Списки координаторов не обновляются. Координаторы, которые ссылаются на этого агента в своём списке multiagent.agents, сохраняют версию, которая была закреплена при создании или последнем обновлении координатора, даже если в ссылке не указано поле version. Чтобы делегировать задачи новой версии, обновите координатора, чтобы его список ссылался на неё.



Жизненный цикл агента



Список версий

Получите полную историю версий, чтобы отслеживать, как агент изменялся со временем. Результаты разбиты на страницы, и примеры с SDK автоматически получают все страницы.

ant beta:agents:versions list --agent-id "$AGENT_ID"



Архивирование агента

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

ant beta:agents archive --agent-id "$AGENT_ID"



Дальнейшие шаги