Веб-поиск в приложении
Серверный поиск и пользовательские инструменты
Способы подключения
| Способ | Кто выполняет поиск | Условие |
|---|---|---|
| Пользовательская функция | Ваше приложение | Модель поддерживает tools, подключён поисковый сервис |
| Встроенный серверный инструмент | Сервис выбранного подключения | Явная поддержка инструмента моделью и маршрутом |
Текстовый запрос с просьбой «найти в интернете» сам по себе не включает поиск
Пользовательский инструмент
Опишите функцию поиска через tools. Ниже только описание функции, его нужно добавить в запрос Chat Completions
{
"type": "function",
"function": {
"name": "search_web",
"description": "Поиск публичных страниц по запросу",
"parameters": {
"type": "object",
"properties": {
"query": {"type": "string"}
},
"required": ["query"],
"additionalProperties": false
}
}
}После получения вызова приложение выполняет поиск и возвращает текст результатов, URL и заголовки через сообщение tool с исходным tool_call_id
Полный цикл описан в руководстве по инструментам
Встроенный поиск
Тип web_search в Responses не является обычной пользовательской функцией. Перед использованием уточните поддержку модели, параметры и тариф
Совместимость с POST /v1/responses не гарантирует поддержку серверного поиска
Источники и безопасность
Показывайте пользователю ссылки, реально возвращённые поиском. Не превращайте сгенерированный моделью URL в подтверждённый источник
Веб-страницы являются недоверенными данными. Их текст не должен менять права инструмента, раскрывать ключи или разрешать запросы к внутренним адресам
Ограничьте число поисковых вызовов, время ожидания и размер результатов