AI Агенты и Tool Use · Урок 2

Function calling в Claude

Полный цикл tool_use в Claude: блоки tool_use и tool_result, параллельные вызовы и принудительный выбор инструмента через tool_choice.

30 мин чтения4 вопроса в квизеГотовый промпт включёнВ работе

Практическое задание

Что сделать после урока

Реализуйте полный цикл: запрос → tool_use → выполнение функции → tool_result → финальный ответ. Добавьте обработку случая с двумя параллельными tool_use блоками в одном ответе. Верните для каждого свой tool_result в одном user-сообщении.

Проверка задания

Реализуйте полный цикл: запрос → tool_use → выполнение функции → tool_result → финальный ответ. Добавьте обработку случая с двумя параллельными tool_use блоками в одном ответе. Верните для каждого свой tool_result в одном user-сообщении.

Ваш ответ

Готовый промпт

Шаблон под задачу урока

Скопируйте и адаптируйте под свой контекст. Текст в треугольных скобках — то, что нужно заменить.

Помоги реализовать tool use loop на Claude (anthropic Python SDK).
Инструменты: <список с input_schema>
Особенность: <параллельные вызовы / forced tool / extraction>

Дай рабочий код: цикл while по stop_reason == "tool_use",
аккумуляция messages, корректная привязка tool_result к tool_use_id,
обработка is_error. Без фреймворков.

Цикл tool_use в Claude

Claude возвращает stop_reason: "tool_use", а в content появляется блок tool_use с id, name, input. Вы выполняете функцию и продолжаете тот же диалог, добавив сообщение role: "user" с блоком tool_result.

import anthropic client = anthropic.Anthropic() tools = [ { "name": "get_weather", "description": "Get current weather for a city. Use when the user asks about weather.", "input_schema": { "type": "object", "properties": { "city": {"type": "string", "description": "City name"}, "units": {"type": "string", "enum": ["celsius", "fahrenheit"]} }, "required": ["city"] } } ] messages = [{"role": "user", "content": "What's the weather in Paris?"}] response = client.messages.create( model="claude-sonnet-4-5", max_tokens=1024, tools=tools, messages=messages, ) if response.stop_reason == "tool_use": tool_block = next(b for b in response.content if b.type == "tool_use") result = run_weather(tool_block.input["city"]) # ваш код messages.append({"role": "assistant", "content": response.content}) messages.append({ "role": "user", "content": [{ "type": "tool_result", "tool_use_id": tool_block.id, "content": result, }], }) final = client.messages.create( model="claude-sonnet-4-5", max_tokens=1024, tools=tools, messages=messages, ) print(final.content[0].text)

Ключевой момент: вы возвращаете весь response.content ассистента (он может содержать текст + несколько tool_use блоков), а каждый tool_result ссылается на tool_use_id.

Параллельные вызовы

Claude может в одном ответе запросить несколько инструментов сразу. Тогда в content будет несколько tool_use блоков. Вы обязаны вернуть tool_result для каждого id в одном пользовательском сообщении, иначе API отклонит запрос.

Принудительный выбор: tool_choice

tool_choice={"type": "tool", "name": "get_weather"} # обязательно этот инструмент tool_choice={"type": "any"} # любой, но точно инструмент tool_choice={"type": "auto"} # по умолчанию: модель решает

tool_choice: "any"/"tool" отключает текстовый ответ — полезно для extraction-задач, где вы хотите строго структурированный JSON. Ошибку из функции возвращайте как tool_result с "is_error": true — Claude попробует исправиться.

Сообщить об ошибке

Function calling в Claude

Проверка задания

Песочница промптов

Квиз — 4 вопроса

Обсуждение

Цикл tool_use в Claude

Параллельные вызовы

Принудительный выбор: tool_choice