Что такое инструменты

О чём урок

Что такое использование инструментов (tool use)? Ваши текущие рабочие процессы опираются на множество различных технологий — программное обеспечение для управления проектами, базы данных, файлы. Claude не может проверять эти вещи самостоятельно. Вместо этого он полагается на инструменты (tools), которые предоставляют Claude доступ к внешним данным и действиям. Проще говоря, инструмент (tool) — это функция, которую вы определяете и предоставляете Claude. Вы описываете, что она делает и какие входные данные принимает, а Claude решает, когда её вызвать. Вот что важно усвоить: Claude не выполняет инструмент (tool) — это делает ваш код. Процесс выглядит так: Claude запрашивает вызов инструмента (tool call). Ваш код выполняет функцию. Результат возвращается Claude, и он продолжает работу. Инструменты (tools) представляют собой JSON-схемы, состоящие из трёх частей: имени, описания и схемы входных данных (input schema). Вы передаёте их Claude в теле запроса как массив tools. Описание — это то, что Claude читает, чтобы решить, вызывать ли инструмент. Если вы напишете расплывчатое описание, вы получите неэффективное использование инструментов (tool use). Это основная причина, по которой агенты дают сбой или не используют доступные им инструменты. Будьте конкретны. Вот как выглядит определение инструмента: json Итак, что происходит, когда мы это используем? Предположим, мы отправляем агенту отчёт о соответствии. На первом шаге Claude возвращает stop_reason: "tool_use" — это наш сигнал. Вот как выглядит этот ответ: Наш цикл вызывает lookup_building_code с параметром, запрошенным Claude, затем передаёт результат обратно как результат инструмента (tool result) — пользовательское сообщение, содержащее блок tool_result, привязанный к идентификатору вызова инструмента: И Claude продолжает работу. На этом этапе мы можем продолжать вызывать инструменты и возвращать результаты Claude, пока он не получит то, что ему нужно. Один инструмент полезен, но самое интересное — это предоставить Claude множество инструментов и наблюдать, как он выбирает, какой из них использовать и в каком порядке.

План урока

1. Что такое инструмент (tool)
2. Как определяются инструменты (tools)
3. Множество инструментов (tools): позволяем Claude выбирать
4. Tool runner: избавляемся от шаблонного кода
5. Реальные инструменты (tools) оборачивают ваш существующий код
6. Резюме