Определение агента

Инструменты

Настройте инструменты, доступные вашему агенту.

Claude Managed Agents предоставляет набор встроенных инструментов, которые Claude может использовать автономно в рамках сессии. Вы управляете тем, какие инструменты доступны, указывая их в конфигурации агента.

Также поддерживаются пользовательские инструменты, определяемые пользователем. Ваше приложение выполняет эти инструменты отдельно и отправляет результаты обратно в Claude; Claude может использовать результаты для продолжения текущей задачи.

Все запросы к Managed Agents API требуют бета-заголовка managed-agents-2026-04-01. SDK устанавливает бета-заголовок автоматически.

Доступные инструменты

Набор инструментов агента включает следующие инструменты. Все они включены по умолчанию, когда вы добавляете набор инструментов в конфигурацию агента.

Инструмент	Название	Описание
Bash	`bash`	Выполнение bash-команд в сессии оболочки
Read	`read`	Чтение файла из локальной файловой системы
Write	`write`	Запись файла в локальную файловую систему

Was this page helpful?

agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Coding Assistant",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401",
      "configs": [
        {"name": "web_fetch", "enabled": false}
      ]
    }
  ]
}
EOF
)

{
  "type": "agent_toolset_20260401",
  "default_config": { "enabled": false },
  "configs": [
    { "name": "bash", "enabled": true },
    { "name": "read", "enabled": true },
    { "name": "write", "enabled": true }
  ]
}

agent=$(curl -fsSL https://api.anthropic.com/v1/agents \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  -d @- <<'EOF'
{
  "name": "Weather Agent",
  "model": "claude-sonnet-4-6",
  "tools": [
    {
      "type": "agent_toolset_20260401"
    },
    {
      "type": "custom",
      "name": "get_weather",
      "description": "Get current weather for a location",
      "input_schema": {
        "type": "object",
        "properties": {
          "location": {"type": "string", "description": "City name"}
        },
        "required": ["location"]
      }
    }
  ]
}
EOF
)

Предоставляйте крайне подробные описания. Это, безусловно, наиболее важный фактор в производительности инструментов. Ваши описания должны объяснять, что делает инструмент, когда его следует использовать (и когда не следует), что означает каждый параметр и как он влияет на поведение инструмента, а также любые важные оговорки или ограничения. Чем больше контекста вы можете дать Claude о ваших инструментах, тем лучше он будет решать, когда и как их использовать. Стремитесь к не менее 3-4 предложениям на описание инструмента, больше, если инструмент сложный.
Объединяйте связанные операции в меньшее количество инструментов. Вместо того чтобы создавать отдельный инструмент для каждого действия (create_pr, review_pr, merge_pr), группируйте их в один инструмент с параметром action. Меньшее количество более мощных инструментов снижает неоднозначность выбора и упрощает навигацию по вашей библиотеке инструментов для Claude.
Используйте значимые пространства имён в названиях инструментов. Когда ваши инструменты охватывают несколько сервисов или ресурсов, добавляйте к именам префикс ресурса (например, db_query, storage_read). Это делает выбор инструмента однозначным по мере роста вашей библиотеки.
Проектируйте ответы инструментов так, чтобы они возвращали только высокоинформативные данные. Возвращайте семантические, стабильные идентификаторы (например, слаги или UUID), а не непрозрачные внутренние ссылки, и включайте только те поля, которые нужны Claude для обдумывания следующего шага. Раздутые ответы расходуют контекст и затрудняют для Claude извлечение важной информации.

Инструменты

Доступные инструменты

Инструменты

Доступные инструменты

Настройка набора инструментов

Отключение конкретных инструментов

Включение только конкретных инструментов

Пользовательские инструменты

Лучшие практики для определения пользовательских инструментов