Инструменты

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

Claude Managed Agents также поддерживает пользовательские инструменты, определяемые пользователем. Ваше приложение выполняет эти инструменты отдельно и возвращает результаты Claude, который использует их для продолжения задачи. Чтобы предоставить агенту инструменты с сервера MCP, используйте вместо этого коннектор MCP.



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

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

Когда вывод инструмента превышает 100 000 токенов, он автоматически записывается в файл в песочнице. Модель получает усечённый предварительный просмотр с путём к файлу и может прочитать полное содержимое оттуда.



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

Включите полный набор инструментов с помощью agent_toolset_20260401 при создании агента. Используйте массив configs, чтобы отключить определённые инструменты или переопределить их настройки. Каждая запись конфигурации также может задавать permission_policy, который определяет, одобряются ли вызовы инструмента автоматически или требуют подтверждения. См. раздел Политики разрешений для ознакомления с доступными типами политик.

ant beta:agents create <<'YAML'
name: Coding Assistant
model: claude-opus-4-8
tools:
  - type: agent_toolset_20260401
    configs:
      - name: web_fetch
        enabled: false
YAML



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

Чтобы отключить инструмент, установите enabled: false в его записи конфигурации в объекте набора инструментов массива tools вашего агента:

{
  "type": "agent_toolset_20260401",
  "configs": [
    { "name": "web_fetch", "enabled": false },
    { "name": "web_search", "enabled": false }
  ]
}



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

Объект default_config задаёт базовую конфигурацию для каждого инструмента в наборе, а записи configs для отдельных инструментов переопределяют её. Чтобы начать с отключённого состояния и включить только то, что вам нужно, установите default_config.enabled в значение false:

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



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

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

Каждый пользовательский инструмент определяет контракт: вы указываете, какие операции доступны и что они возвращают, а Claude определяет, когда и как их вызывать. Модель никогда ничего не выполняет самостоятельно. Она выдаёт структурированный запрос, ваш код выполняет операцию, и результат возвращается обратно в диалог. См. раздел Поток событий сессии, чтобы узнать, как получать вызовы пользовательских инструментов и возвращать результаты во время сессии.

ant beta:agents create <<'YAML'
name: Weather Agent
model: claude-opus-4-8
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
YAML

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



Рекомендации по определению пользовательских инструментов

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



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