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

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

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

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

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

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

ant beta:agents create \
  --name "Coding Assistant" \
  --model '{id: claude-opus-4-7}' \
  --system "You are a helpful coding agent." \
  --tool '{type: agent_toolset_20260401}'

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

{
  "id": "agent_01HqR2k7vXbZ9mNpL3wYcT8f",
  "type": "agent",
  "name": "Coding Assistant",
  "model": {
    "id": "claude-opus-4-7",
    "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
}

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

Обновление агента генерирует новую версию. Передайте текущую version, чтобы убедиться, что вы обновляете из известного состояния.

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

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

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

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

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

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

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

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

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

Получите полную историю версий для отслеживания того, как агент изменялся во времени.

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

Архивируйте агента

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

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

Следующие шаги

• Настройте инструменты для настройки того, какие возможности может использовать агент.
• Прикрепите навыки для специализированного опыта в области.
• Начните сеанс, который ссылается на вашего агента.