Программа курса Урок 117 из 250 · Вызов реальной LLM
Вызов реальной LLM

Двусторонний вызов инструмента

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.

Заметили проблему в этом уроке? Сообщите о ней · Спросить об этом уроке

Это упражнение откроется скоро

Закончи предыдущий урок, чтобы открылся этот. Весь курс бесплатный, аккаунт не нужен, и ты можешь прочитать этот урок прямо сейчас.