Utiliser DeepSeek Search et Fetch dans Hermes Agent
Hermes peut répondre avec un modèle DeepSeek, mais il lui faut un service de recherche configuré pour trouver des informations récentes et fournir des liens. Ce guide présente le plugin communautaire deepseek-search-fetch, qui relie les outils web de Hermes aux API Search et Fetch de DeepSeek.
Les instructions suivent la documentation publiée pour la version 1.0.10 du plugin. Elles n'ont pas été testées sur une installation Hermes réelle pour cet article. Les menus et le comportement peuvent changer avec les mises à jour.
À quoi servent Search et Fetch ?
| Outil | Fonction | Exemple |
|---|---|---|
| Search | Trouve des pages correspondant à une requête. | Chercher la documentation récente de DeepSeek sur les appels d'outils. |
| Fetch | Récupère le contenu d'une page à partir de son URL. | Lire une page de documentation avant de la résumer. |
| Modèle | Interprète les résultats et rédige une réponse. | Comparer les pages récupérées et citer leurs URL. |
Ces services sont distincts. Une réponse du modèle ne prouve pas que Hermes a effectué une recherche ou lu une page.
Que faut-il avant l'installation ?
- Hermes Agent 0.22.0 ou une version ultérieure, dans le profil que vous utiliserez.
- Une clé API DeepSeek directe et un compte disposant d'un solde API utilisable. Un identifiant de chat n'est pas une clé API.
- L'autorisation d'installer un plugin communautaire et d'exécuter du code dans l'environnement Hermes.
- Un modèle fonctionnel dans Hermes. Il peut s'agir d'un modèle DeepSeek, mais le service web et le modèle de chat se configurent séparément.
Le plugin est maintenu par la communauté. Examinez son code et ses permissions avant de l'installer : il s'exécute dans l'environnement Hermes et peut accéder aux identifiants disponibles. Ne placez pas votre clé API dans une capture d'écran, un message ou l'historique du terminal.
Les requêtes et les URL transmises à Fetch sont envoyées à DeepSeek, qui récupère les pages depuis ses serveurs. Pour les tests, utilisez des pages publiques et évitez les recherches sensibles ou les URL privées. Si Hermes bascule vers un autre fournisseur, celui-ci peut recevoir la requête ou l'URL.
Si vous partez de zéro, consultez d'abord notre guide de configuration de Hermes avec DeepSeek. Une clé Coding Plan ou celle d'un autre fournisseur peut utiliser un endpoint et des droits différents ; ne supposez pas qu'elle fonctionne avec l'API de recherche directe de DeepSeek.
Comment installer et configurer le plugin ?
Sauvegardez la configuration du profil Hermes avant de modifier les services web. Notez les paramètres actuels de recherche et d'extraction pour pouvoir les restaurer. Utilisez le même profil pour le plugin, la clé et la session Hermes.
1. Installer le plugin communautaire
Dans un terminal où le profil voulu est actif, installez et activez le plugin :
hermes plugins install deepseek-search-fetch --enableDémarrez une nouvelle session. Si Desktop ou le gateway est déjà lancé, redémarrez-le pour charger le plugin. Vérifiez qu'il figure dans la liste et qu'il est activé :
hermes plugins list
hermes tools2. Ajouter la clé API DeepSeek directe
Enregistrez DEEPSEEK_API_KEY dans les secrets privés ou les paramètres d'environnement du profil concerné. Si Hermes utilise déjà une clé directe dans ce profil, vérifiez que le plugin peut y accéder. Ne collez pas la clé dans le chat ni dans une commande conservée dans l'historique du terminal.
3. Sélectionner les services web
Dirigez les deux opérations vers le fournisseur enregistré par ce plugin :
hermes config set web.search_backend deepseek
hermes config set web.extract_backend deepseekLe nom de fournisseur deepseek correspond ici à deepseek-search-fetch. D'autres plugins aux noms proches peuvent utiliser un autre nom ou une autre configuration. Activez la recherche et l'extraction dans Hermes et conservez vos paramètres précédents pour revenir en arrière.
Comment vérifier que cela fonctionne ?
Dans une nouvelle session, testez séparément la recherche et l'extraction avec des informations publiques et une requête non sensible.
- Recherche : demandez à Hermes de trouver la documentation DeepSeek actuelle sur Search et Fetch et de renvoyer deux URL. Vérifiez l'activité
web_searchet les liens. - Extraction : demandez-lui de lire une des pages publiques et d'en résumer un détail. Vérifiez l'appel distinct
web_extractet comparez la réponse à la page. - Fournisseur : vérifiez la configuration et les diagnostics ou données d'utilisation disponibles. Une réponse plausible ou un appel réussi ne prouve pas à lui seul que DeepSeek a traité la requête.
Notez les versions de Hermes et du plugin, le profil, l'heure et le résultat de chaque test. Consultez les journaux ou données d'utilisation s'ils permettent d'identifier le fournisseur, sans enregistrer la clé ou une requête privée. Si les éléments ne permettent pas de l'identifier, indiquez que le fournisseur n'est pas confirmé.
Quand utiliser ce plugin ?
Il peut convenir si vous disposez déjà d'un compte API DeepSeek direct et souhaitez utiliser DeepSeek pour rechercher et extraire des pages. Si votre service actuel répond à vos besoins ou si vous ne souhaitez pas ajouter un service payant, vous pouvez le conserver. Ce guide ne compare pas la qualité, la vitesse ou la fiabilité des fournisseurs.
Les résultats de recherche sont des pistes, pas des preuves. Ouvrez la page, vérifiez sa date et contrôlez l'information dans le texte original. Fetch peut échouer sur certains sites, et une page récupérée peut contenir des informations anciennes ou erronées.
Combien cela coûte-t-il ?
Tarifs publiés par DeepSeek et consultés le 9 novembre 2026. Search et Fetch sont des API distinctes ; les jetons d'entrée et de sortie du modèle sont facturés à part. Les prix et les conditions d'accès peuvent changer.
| Service | Prix publié | Exemple |
|---|---|---|
| Search | 0,75 USD pour 1 000 requêtes réussies | 100 recherches : 0,075 USD |
| Fetch | 0,75 USD pour 1 000 requêtes réussies | 100 extractions : 0,075 USD |
Par exemple, 100 recherches et 100 extractions réussies coûtent au total 0,15 USD, hors jetons du modèle et autres frais. Selon DeepSeek, une requête facturable doit renvoyer HTTP 200 et produire un résultat ; les échecs, résultats vides et délais expirés ne sont pas facturés selon les règles publiées. Vérifiez votre compte et les tarifs actuels avant d'utiliser cette estimation.
Que vérifier si la recherche échoue ?
| Symptôme | Première vérification |
|---|---|
| Le chat fonctionne, mais pas la recherche | Vérifiez web_search, le plugin dans le profil actif et le service de recherche deepseek. |
| Clé absente ou HTTP 401 | Vérifiez que la clé directe est accessible au même profil et au même processus. Ne l'affichez pas et ne la partagez pas. |
| HTTP 402 | Vérifiez le solde et l'accès à la facturation du compte DeepSeek. |
| HTTP 429 ou erreur serveur temporaire | Réduisez la fréquence et réessayez plus tard. Des limites par compte et une limite supplémentaire par domaine s'appliquent à Fetch. |
| Des liens apparaissent, mais une page ne peut pas être lue | Essayez une autre page publique. Le site peut bloquer les accès automatisés ou nécessiter un rendu que Fetch ne fournit pas. |
| Une réponse arrive, mais le fournisseur est incertain | Vérifiez la configuration, l'activité des outils et les données d'utilisation. Un service de secours peut masquer un échec DeepSeek. |
Pour les problèmes généraux de modèle, de clé ou de profil, consultez le guide de dépannage Hermes.
Comment retrouver la configuration précédente ?
Restaurez les valeurs de recherche et d'extraction notées avant l'installation. Si vous n'avez plus besoin du plugin, désactivez-le :
hermes plugins disable deepseek-search-fetchSi aucune valeur n'était définie auparavant, la documentation du plugin indique ces commandes pour supprimer les réglages explicites :
hermes config unset web.search_backend
hermes config unset web.extract_backendSupprimer ces valeurs ne restaure pas automatiquement un autre fournisseur configuré auparavant. Démarrez une nouvelle session et vérifiez le service souhaité. Conservez les autres paramètres de modèle, de mémoire et d'outils.
Questions fréquentes
La recherche DeepSeek est-elle incluse avec un modèle DeepSeek ?
Non. Le modèle, Search et Fetch sont des services distincts. Configurez et testez le fournisseur web séparément.
Le plugin est-il officiel ?
Non. Il est maintenu par la communauté et sa fiche précise qu'il n'est pas affilié à DeepSeek.
Toutes les recherches passent-elles par DeepSeek ?
Non. Le service actif et les paramètres de secours déterminent le parcours ; un autre fournisseur peut traiter une requête échouée.
Le plugin peut-il lire tous les sites ?
Non. Certains bloquent les accès automatisés ou nécessitent le rendu d'un navigateur. Testez les pages dont vous avez besoin.
Puis-je utiliser ma clé Coding Plan ?
Uniquement si votre fournisseur confirme la prise en charge des API Search et Fetch avec cette clé et cet endpoint. L'accès au modèle ne garantit pas l'accès à la recherche.
Vous devez d'abord configurer le modèle ? Commencez par le guide DeepSeek et Hermes, puis revenez configurer la recherche.