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

Что такое tool use

Tool use позволяет модели вызывать ваши функции вместо галлюцинации ответа. Разбираем JSON Schema, цикл вызова и различия Claude / OpenAI / Gemini.

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

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

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

Опишите три инструмента (get_weather, search_docs, send_email) в формате JSON Schema. Для каждого напишите description в 1–2 предложения, явно указывающее, КОГДА модель должна его звать. Отметьте обязательные поля через required.

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

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

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

Я проектирую набор инструментов для AI-агента.
Домен: <…>
Список действий, которые агент должен уметь: <…>

Для каждого действия предложи tool в формате JSON Schema:
имя (snake_case), description с явным условием вызова, типизированные
параметры, required. Укажи, какие действия НЕ стоит делать инструментами.

Зачем нужен tool use

LLM сама по себе не умеет узнать сегодняшнюю погоду, прочитать вашу БД или отправить письмо. Tool use (он же function calling) — это контракт: вы описываете инструменты, модель решает, какой и с какими аргументами вызвать, ваш код выполняет вызов и возвращает результат обратно в диалог.

Важно понимать: модель не выполняет код. Она лишь генерирует структурированный запрос «вызови get_weather с {city: "Paris"}». Исполнение — на вас.

Цикл tool use

Вы отправляете сообщение + список инструментов.

Модель отвечает либо текстом, либо запросом на вызов инструмента (stop_reason: "tool_use" у Claude, finish_reason: "tool_calls" у OpenAI).

Вы выполняете функцию и отправляете результат назад.

Модель формулирует финальный ответ на основе результата.

Схема инструмента — это JSON Schema

Все провайдеры описывают параметры через JSON Schema:

tool = { "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, e.g. 'Paris'"}, "units": {"type": "string", "enum": ["celsius", "fahrenheit"]} }, "required": ["city"] } }

Различия провайдеров

Claude: ключ tools, схема в input_schema, в ответе блок tool_use, результат — блок tool_result.

OpenAI: массив tools с обёрткой {"type": "function", "function": {...}}, схема в parameters, в ответе tool_calls, результат — сообщение с role: "tool".

Gemini: function_declarations внутри tools, в ответе functionCall, результат — functionResponse part.

Семантика одинаковая, отличаются только имена полей. Качество описания инструмента влияет на точность вызовов сильнее, чем выбор провайдера: расплывчатое description приводит к лишним или пропущенным вызовам.

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

Что такое tool use

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

Зачем нужен tool use

Цикл tool use

Схема инструмента — это JSON Schema

Различия провайдеров