search.sh

Chaque recherche renvoie un objet JSON avec une réponse générée par IA, une liste de sources classée, des citations, un score de confiance et des requêtes associées. Vous évitez ainsi de coudre ensemble un appel de recherche et un appel séparé au modèle. Le score de confiance reflète l'accord entre les sources et le degré d'ancrage de la réponse, ce qui laisse votre application décider si elle s'y fie.

Le mode rapide lance une seule requête et vise un retour en moins de cinq secondes, pour un crédit. Le mode approfondi génère des sous-requêtes, les cherche en parallèle, extrait le contenu des pages et croise les résultats, pour cinq crédits. Le mode approfondi est celui qu'il faut quand une question a plusieurs angles, et le mode rapide couvre les vérifications d'un coup d'œil. Si le travail est une recherche approfondie, c'est le mode approfondi qui change la donne.

Search.sh confronte chaque citation au texte de sa source. Il écarte celles que la source n'étaye pas et marque le reste comme vérifié. Il lit aussi les dates de publication et de modification de chaque page et signale quand une source récente contredit une ancienne. Quand l'exactitude compte, c'est là que le produit se justifie.

Les résultats peuvent arriver par des événements envoyés par le serveur, donc sources, morceaux de réponse et citations apparaissent dès qu'ils sont prêts au lieu d'attendre la fin de l'appel. L'endpoint d'extraction tire du texte propre de n'importe quelle URL, prend en charge le PDF et un repli via Wayback, et rend jusqu'à 40 000 caractères par page. Les deux aident si vous bâtissez une interface en direct.

L'endpoint par lots accepte jusqu'à dix requêtes en un seul aller-retour, ce qui réduit la latence quand il vous faut plusieurs réponses d'un coup. La recherche par empreinte trouve où un passage apparaît déjà sur le web via un hachage de fragments, sans lancer une recherche complète. Elle aide pour la détection de doublons et les contrôles de contenu.

Vous pouvez viser une région précise ou passer en global, avec 30 régions disponibles. Des contrôles de fraîcheur comme since et freshness_boost font remonter les sources récentes, et les résultats filtrés par date ne sont mis en cache qu'une heure pour rester à jour. C'est l'ensemble de réglages qu'il vous faut quand une requête simple n'est plus assez précise.