Двусторонний вызов инструмента
Tool calling это танец из двух шагов. Вы отправляете сообщение пользователя вместе со своими tool schemas; модель отвечает блоком tool_use с текстом "call get_weather with {city: 'Paris'}"; ваш код запускает эту функцию и отправляет ответ обратно как tool_result; затем модель использует его для написания финального ответа. Этот урок посвящен среднему шагу -> части, где запрос модели становится реальным вызовом Python и результат упаковывается для обратного пути.
Вот настоящий цикл (только для иллюстрации -> мы не вызываем сеть):
resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
tools=TOOLS, messages=history)
# resp.stop_reason == "tool_use". The model may ask for SEVERAL tools at once:
# append its turn once, run every tool_use block, and send ALL the results
# back together in ONE user message.
history.append({"role": "assistant", "content": resp.content})
results = []
for block in resp.content:
if block.type == "tool_use":
result = TOOLS_BY_NAME[block.name](**block.input)
results.append({"type": "tool_result", "tool_use_id": block.id,
"content": str(result)})
history.append({"role": "user", "content": results})
final = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
tools=TOOLS, messages=history)Необсуждаемые детали: вы вызываете функцию, которую модель назвала с аргументами, которые она дала, вы возвращаете её tool_use_id обратно в tool_result, чтобы модель могла сопоставить каждый ответ со своим запросом, и когда один ход просит несколько инструментов, вы возвращаете каждый результат в одном сообщении пользователя (разделение их по сообщениям учит модель перестать запрашивать параллельно). В этом уроке вы обрабатываете самый простой случай, один вызов инструмента; урок 4 обрабатывает несколько. Мы моделируем ответ как обычный словарь, чтобы он работал офлайн:
{"content": [{"type": "tool_use", "id": "toolu_1",
"name": "get_weather", "input": {"city": "Paris"}}],
"stop_reason": "tool_use"}Вы строите run_tool_call(resp, tools), где tools сопоставляет имя инструмента с Python функцией. Она должна:
- Найдите первый блок в
resp["content"], у которогоtypeравен"tool_use". - Найдите
tools[name]и вызовите его сinputблока как именованные аргументы:tools[name](**block["input"]). Если имени нет вtools, вызовите (KeyErrorилиValueError) -> никогда не запускайте инструмент, который придумала модель. - Верните сообщение пользователя для последующего шага, которое возвращает результат:
{"role": "user",
"content": [{"type": "tool_result",
"tool_use_id": <the block's id>,
"content": str(result)}]}Превратите результат в строку с помощью str(result) -> содержимое tool_result передается как текст. Соберите это так, чтобы два разных вызова инструментов (разные имя и входные данные) давали два разных сообщения tool_result, исходный tool_use_id возвращался обратно, а неизвестное имя инструмента вызывало ошибку.
Напишите run_tool_call(resp, tools). Найдите первый блок {"type": "tool_use", "id", "name", "input"} в resp["content"], вызовите tools[name](**input) и верните последующее сообщение {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]}. Выдай ошибку на имя инструмента, которого нет в tools.
Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке
Это упражнение откроется скоро
Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.
Этот браузер блокирует cookies для learn.floati.life, поэтому завершенные здесь уроки не могут открыться по порядку. Разрешите cookies для этого сайта и перезагрузите страницу.