Recherche et récupération web DeepSeek
Choisissez la recherche directe, la récupération de pages ou des outils web exécutés par un modèle.
Choisir le mode d'appel
| Besoin | Méthode |
|---|---|
| Trouver des pages par mots-clés et traiter les résultats | Search renvoie des liens, des résumés et du contenu facultatif ; aucun model requis |
| Lire le contenu d'une URL connue | Fetch renvoie le titre et le contenu Markdown ; aucun model requis |
| Laisser un modèle rechercher puis répondre | Déclarez des outils web côté serveur via Responses ou Messages ; le modèle choisit et exécute les opérations |
Les requêtes suivantes utilisent une API Key de la plateforme. Les API autonomes comme les outils des modèles peuvent être facturés.
Rechercher et récupérer directement
1. Rechercher sur le web
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
}'Choisissez une page pertinente dans results et lisez son url. En l'absence de résultats, ajustez la requête ou son périmètre. Définissez need_content: true pour inclure le contenu des pages.
2. Récupérer la page choisie
Remplacez l'URL ci-dessous par le results[].url sélectionné à l'étape précédente :
curl 'https://api.agtcloud.ai/v1/tools/fetch' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"url": "https://example.com/"
}'Lisez title et content ; utilisez le Markdown pour l'affichage, la recherche ou comme entrée du modèle. Chaque recherche et récupération réussie est facturée séparément. Plusieurs résultats comptent toujours comme une seule requête de recherche.
Laisser le modèle utiliser les outils web
Remplacez MODEL_ID par l'ID complet d'un modèle prenant en charge l'outil concerné. Les outils s'exécutent côté serveur ; le client n'a pas à rechercher ni à renvoyer leurs résultats.
Choisissez deepseek-v4-pro. web_search effectue des recherches et ouvre des pages ; inutile de déclarer un outil Fetch distinct.
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": "Recherchez le site officiel de Python, lisez les pages pertinentes, présentez brièvement son utilité et fournissez les liens des sources."
}'Consultez Responses et Messages pour les structures complètes des requêtes et réponses.
Lire les résultats et l'utilisation
| Méthode | Emplacement et signification |
|---|---|
| Search / Fetch autonomes | Lisez results pour Search et title/content pour Fetch ; aucun usage supplémentaire |
| Résultats Responses | web_search_call dans output décrit les opérations web ; la réponse finale se trouve dans le texte du message |
| Utilisation Responses | usage.server_tool_use.tool_search compte les recherches réussies ; un appel contenant plusieurs requêtes peut être compté plusieurs fois. tool_fetch compte les lectures réussies, y compris l'ouverture de pages et la recherche de texte dans une page. server_tool_use est omis si les deux compteurs sont nuls |
| Résultats Messages | content contient server_tool_use, web_search_tool_result et les blocs de texte de la réponse finale |
| Utilisation Messages | usage.server_tool_use.web_search_requests compte les tentatives, y compris les échecs ou les dépassements de max_uses. tool_search compte les recherches réussies avec résultats ; la plateforme facture la recherche selon ce nombre |
| Utilisation en streaming | Pour Responses, lisez response.usage dans le dernier événement response.completed/incomplete/failed. Pour Messages, lisez les valeurs cumulées du dernier message_delta.usage, sans les additionner à l'événement initial |
Déclarer un outil ne garantit pas une recherche ; fiez-vous aux compteurs renvoyés. Responses ignore max_tool_calls, et le nombre demandé dans le prompt ne plafonne pas les opérations facturées.