Инструменты

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

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

Инструмент	Имя	Описание
Bash	`bash`	Выполнение команд bash в сеансе оболочки
Read	`read`	Чтение файла из локальной файловой системы
Write	`write`	Запись файла в локальную файловую систему
Edit	`edit`	Выполнение замены строк в файле
Glob	`glob`	Быстрое сопоставление шаблонов файлов с использованием глоб-шаблонов
Grep	`grep`	Поиск текста с использованием регулярных выражений
Web fetch	`web_fetch`	Получение содержимого с URL
Web search	`web_search`	Поиск информации в Интернете

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

Включите полный набор инструментов с помощью agent_toolset_20260401 при создании агента. Используйте массив configs для отключения определенных инструментов или переопределения их параметров.

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

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

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

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

Чтобы начать со всего отключенного и включить только то, что вам нужно, установите 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 для выполнения более широкого спектра задач. Каждый инструмент определяет контракт: вы указываете, какие операции доступны и что они возвращают; Claude решает, когда и как их вызывать. Модель никогда не выполняет ничего самостоятельно. Она выдает структурированный запрос, ваш код выполняет операцию, и результат возвращается в беседу.

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

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

Предоставляйте чрезвычайно подробные описания. Это, безусловно, наиболее важный фактор в производительности инструмента. Ваши описания должны объяснять, что делает инструмент, когда его следует использовать (и когда не следует), что означает каждый параметр и как он влияет на поведение инструмента, а также любые важные предостережения или ограничения. Чем больше контекста вы можете дать Claude о ваших инструментах, тем лучше он будет решать, когда и как их использовать. Стремитесь к описанию инструмента из по крайней мере 3-4 предложений, больше, если инструмент сложный.

Консолидируйте связанные операции в меньшее количество инструментов. Вместо создания отдельного инструмента для каждого действия (create_pr, review_pr, merge_pr), группируйте их в один инструмент с параметром action. Меньше, но более мощные инструменты снижают неоднозначность выбора и облегчают Claude навигацию по поверхности вашего инструмента.

Используйте значимое пространство имен в названиях инструментов. Когда ваши инструменты охватывают несколько сервисов или ресурсов, добавляйте префикс к названиям с ресурсом (например, db_query, storage_read). Это делает выбор инструмента однозначным по мере роста вашей библиотеки.

Разработайте ответы инструментов для возврата только высокосигнальной информации. Возвращайте семантические, стабильные идентификаторы (например, слаги или UUID) вместо непрозрачных внутренних ссылок и включайте только поля, которые Claude нужны для рассуждения о своем следующем шаге. Раздутые ответы тратят контекст и затрудняют для Claude извлечение того, что имеет значение.