О чём урок
Видео: «Встроенные инструменты»
Вы можете создавать свои собственные инструменты, но некоторые возможности настолько распространены, что Anthropic поставляет их в готовом виде. Вы не пишете код. Вы не размещаете sandbox. Вы просто объявляете инструмент, и Anthropic запускает его.
Anthropic предоставляет серверные инструменты, которые работают на их инфраструктуре. Вы не выполняете их — это делает Anthropic. Это означает, что вам не нужен agent loop для этих вызовов. Claude вызывает инструменты самостоятельно, и результат возвращается в том же ответе.
Основные из них:
- Веб-поиск — ищет в интернете и возвращает результаты со ссылками
- Выполнение кода — пишет и запускает Python в sandbox
- Веб-извлечение — извлекает полное содержимое из URL
Давайте рассмотрим некоторые из основных в одном файле: два вызова messages.create, один с веб-поиском и один с выполнением кода.
Две вещи, на которые стоит обратить внимание:
- Здесь нет agent loop. Мы не переключаемся по stop_reason. Мы не отправляем результаты инструмента обратно. Anthropic запускает инструмент на стороне сервера, и ответ уже содержит результат.
- Ответ содержит новые типы блоков. Блок server_tool_use для вызова инструмента, блок результата выполнения кода для output, плюс обычные блоки text.
Для веб-поиска вы увидите распечатанный вызов инструмента Claude, затем одно предложение с ответом о последнем выпущенном модели со включенными ссылками на поиск.
Для выполнения кода вы увидите фактический код Python, написанный Claude, stdout из запущенного sandbox и окончательный текстовый ответ.
Нам не пришлось запускать поисковый краулер. Мы не запускали Python sandbox. Мы объявили два инструмента и получили оба бесплатно.
Стоит знать, что существует другая категория. Клиентские инструменты работают там, где выполняется ваш код. Anthropic публикует их схемы и обучает Claude на них, поэтому вам не нужно определять схему самостоятельно. Два примера:
- Память — Claude читает и записывает память между сессиями
- Bash — постоянная оболочка bash, чтобы Claude мог выполнять команды
Они имеют ту же структуру, что и пользовательский инструмент, но SDK предоставляет вам схему и…
План урока
- Серверные инструменты: объявленные вами, запускаемые Anthropic
- Два серверных инструмента в одном файле
- Запуск
- Другая категория: клиентские инструменты
- Почему это важно в production
- Итоги
Урок входит в полный доступ. Полный текст и видео открываются после оплаты. Первые уроки каждого курса бесплатны.