Веб-поиск и получение страниц DeepSeek
Выберите прямой поиск, получение страниц или веб-инструменты модели для подготовки ответа.
Выбор способа вызова
| Задача | Способ |
|---|---|
| Найти страницы по ключевым словам и самостоятельно обработать результаты | Search возвращает ссылки, описания и необязательное содержимое; model не нужен |
| Прочитать страницу по известному URL | Fetch возвращает заголовок и Markdown; model не нужен |
| Поручить модели поиск и ответ | Объявите серверные веб-инструменты через Responses или Messages; модель выберет и выполнит операции |
Следующие запросы используют API Key платформы. Отдельные API и инструменты моделей могут оплачиваться.
Прямой поиск и получение страниц
1. Поиск в интернете
curl 'https://api.agtcloud.ai/v1/tools/search' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"query": "DeepSeek site:api-docs.deepseek.com",
"count": 5,
"need_content": false
}'Выберите подходящую страницу в results и прочитайте её url. Если совпадений нет, измените запрос или область поиска. Для получения текста страниц в результатах задайте need_content: true.
2. Получение выбранной страницы
Замените URL ниже на results[].url, выбранный на предыдущем шаге:
curl 'https://api.agtcloud.ai/v1/tools/fetch' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"url": "https://example.com/"
}'Прочитайте title и content; используйте Markdown для отображения, поиска или передачи модели. Успешный поиск и получение страницы оплачиваются отдельно. Несколько результатов всё равно считаются одним поисковым запросом.
Использование веб-инструментов моделью
Замените MODEL_ID полным ID модели, поддерживающей нужный инструмент. Инструменты выполняются на сервере; клиенту не нужно искать или отправлять результаты инструментов обратно.
Выберите deepseek-v4-pro. web_search выполняет поиск и открывает страницы; отдельно объявлять Fetch не нужно.
curl 'https://api.agtcloud.ai/v1/responses' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"reasoning": {"effort": "none"},
"max_output_tokens": 4096,
"tools": [{"type": "web_search"}],
"input": "Найдите официальный сайт Python, прочитайте подходящие страницы, кратко опишите его назначение и укажите ссылки на источники."
}'Полные структуры запросов и ответов приведены в Responses и Messages.
Чтение результатов и использования
| Способ | Расположение и значение |
|---|---|
| Отдельные Search / Fetch | Для Search читайте results, для Fetch — title/content; дополнительный usage не возвращается |
| Результаты Responses | web_search_call в output описывает веб-операции; итоговый ответ находится в тексте message |
| Использование Responses | usage.server_tool_use.tool_search считает успешные поисковые запросы; вызов инструмента с несколькими запросами может учитываться несколько раз. tool_fetch считает успешные чтения страниц, включая открытие и поиск текста внутри страницы. Если оба счётчика равны нулю, server_tool_use отсутствует |
| Результаты Messages | content содержит server_tool_use, web_search_tool_result и текстовые блоки итогового ответа |
| Использование Messages | usage.server_tool_use.web_search_requests считает попытки, включая ошибки и превышение max_uses. tool_search считает успешные поиски с результатами; платформа начисляет плату за поиск по этому числу |
| Потоковое использование | В Responses читайте response.usage из финального события response.completed/incomplete/failed. В Messages читайте накопленные значения последнего message_delta.usage, не прибавляя значения начального события |
Объявление инструмента не гарантирует поиск; ориентируйтесь на возвращённые счётчики. Responses игнорирует max_tool_calls, а число в промпте не ограничивает количество оплачиваемых операций.