Как настроить function calling в Grok API и обработать несколько вызовов

for item in response.output:
 if item.type=="function_call":
  args=json.loads(item.arguments)
  result=tools_map[item.name](**validate(args))
  outputs.append({"type":"function_call_output","call_id":item.call_id,"output":json.dumps(result)})
response=client.responses.create(model="grok-4.6",input=outputs,tools=tools,previous_response_id=response.id)

• Встроенные tools выполняются xAI, custom functions — вашим приложением.
• Tool choice поддерживает auto, required, none и принудительный выбор конкретной функции.
• В streaming function call приходит целиком в одном chunk согласно документации.
• До 350 tools на запрос — технический максимум, а не рекомендация проектировать сотни пересекающихся функций.

Как внедрить

1. Зафиксируйте задачу и формат результата.
2. Храните ключ только на сервере и ограничьте доступ.
3. Выполните запрос и разберите структурированные поля ответа.
4. Добавьте таймаут, ограниченный retry и метрики usage/latency.
5. Прогоните положительные, отрицательные и пограничные тесты.

Как проверить результат

Попросите данные по двум городам и убедитесь, что обработаны оба call ID. Добавьте неизвестную функцию и чужой объект — backend должен отклонить их.

Чего не делать

• Не публикуйте API-ключ.
• Не считайте уверенный текст доказательством.
• Не записывайте данные без валидации.
• Не повторяйте 429 или 5xx бесконечно.

Ограничения

Доступность моделей, регионов, функций и тарифов может меняться. Проверяйте официальный каталог на дату внедрения и не отправляйте чувствительные данные без оценки политики обработки.

FAQ