Когда пользователь пишет в чат «болит горло, к кому записаться» — AI не знает расписание врачей вашей клиники. Он НЕ может просто «посмотреть в вашу БД».
Но он может попросить вашу систему это сделать. Именно так работает Tool Calling.
👉 Что такое Tool Calling
Tool Calling — механизм, при котором AI не отвечает текстом, а возвращает команду: «вызови вот этот инструмент с вот этими параметрами».
Ваш бэкенд выполняет вызов, возвращает результат обратно в модель, и только тогда AI формирует финальный ответ пользователю.
❗️ Важно: AI не вызывает ваши сервисы напрямую.
Он только говорит «что сделать». Вызов tool уже на стороне вашего Backend.
👉 Сценарий: пациент описывает симптомы, чтобы получить рекомендацию врачей
🔹 Шаг 1. Пользователь пишет в чат «Три дня болит горло, температура 38»
Сообщение уходит на AI Chat Service.
AI Chat Service отправляет запрос в Groq AI с системным промптом и сообщением пользователя.
В запросе также передаётся список доступных инструментов — tools.
🔹 Шаг 2. Groq AI возвращает tool calls
Groq анализирует симптомы, определяет специализацию врача, но возвращает не текст, а команду:
{
"tool_calls": [{
"function": {
"name": "get_doctors",
"arguments": {
"specialty": "therapist",
"city": "Moscow"
}
}
}]
}
🔹 Шаг 3. AI Chat Service вызывает Сервис Врачей
GET /doctors?specialty=therapist&city=Moscow
Сервис Врачей возвращает список специалистов.
🔹 Шаг 4. Результат возвращается в Groq AI
AI Chat Service передаёт ответ обратно в модель как tool result:
{
"role": "tool",
"content": [{
"doctor_id": "d-001",
"name": "Смирнова Елена Павловна",
"specialty": "therapist",
"rating": 4.9,
"clinic": "Поликлиника №7"
}]
}
🔹 Шаг 5. Groq AI формирует финальный ответ
Теперь у модели есть данные — она отвечает пользователю:
«Судя по симптомам, рекомендую терапевта. Нашел специалистов в вашем городе...»
👉 Каждый tool — это полноценный API-контракт
Для get_doctors нужно описать:
▫️ входные параметры и их типы
▫️ обязательные и необязательные поля
▫️ что возвращается в модель
▫️ обработку ошибок: что вернуть если врачей нет и т.п.
Если контракт описан плохо, AI получит неожиданный ответ и либо сломается, либо даст пользователю неверную информацию.
💡🧡 Чтобы понять как это работает, лучше всего попробовать на практике в Postman
В канале опубликовала практическое руководство по тестированию API Groq AI через через Postman.
В нём показано как работать с tool call и посмотреть что реально возвращает Groq.
🔗 руководство по исследованию API к AI через Postman
Tool calling — это интеграционный API-контракт, где на другой стороне не разработчик, а языковая модель.
С пониманием tool calling можно уверенно переходить к постановке интеграционной задачи с AI 🙌
#ИнтеграцииGA #MedAssistGA #AI_for_analysts
Tg | ВК | Max