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

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

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

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

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

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

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

{
  "id": "agent_01HqR2k7vXbZ9mNpL3wYcT8f",
  "type": "agent",
  "name": "Coding Assistant",
  "model": {
    "id": "claude-sonnet-4-6",
    "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, чтобы убедиться, что вы обновляете из известного состояния.

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

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

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

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

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

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

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

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

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

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

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

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