Recherche Web

​

Quand Utiliser Cet Outil

• Accéder à des Données en Temps Réel : Trouver des informations sur des événements, des prix ou des sorties survenus récemment.
• Vérifier des Faits : Recouper des connaissances internes avec des sources externes.
• Élargir la Recherche : Explorer des sujets en dehors de votre base de connaissances interne.
• Trouver de la Documentation : Consulter les dernières références API ou guides techniques qui pourraient ne pas être dans vos données d’entraînement.

​

Paramètres d’Entrée

​

Structure de Sortie

{
  "query": "dernières avancées batteries solides 2024",
  "response": "L'utilisateur demande des informations sur les avancées récentes dans les batteries à l'état solide. Je dois trouver des informations spécifiques à 2024. En regardant les résultats de recherche, je vois plusieurs articles pertinents...\n\nLes avancées récentes dans les batteries à l'état solide en 2024 se sont concentrées sur l'amélioration de la densité énergétique et des vitesses de charge. Toyota a annoncé une percée revendiquant une autonomie de 745 miles et un temps de charge de 10 minutes <web_citation url=\"https://example.com/toyota-news\" title=\"Toyota News\">[1]</web_citation>. Pendant ce temps, QuantumScape a commencé à expédier des prototypes à des partenaires automobiles <web_citation url=\"https://example.com/quantumscape-update\" title=\"QuantumScape Update\">[2]</web_citation>.",
  "sources": [
    {
      "rank": 1,
      "title": "Feuille de route des batteries solides de Toyota",
      "url": "https://example.com/toyota-news",
      "snippet": "Toyota vise à commercialiser la technologie d'ici 2027...",
      "rerank_score": 0.92,
      "used_in_response": true
    },
    // ... autres sources
  ],
  "sources_used": [1, 2],
  "model": "claude-3-7-sonnet-20250219-thinking",
  "reranker": "llm_multimodal_tool_calling_binary_reranker::gpt-4o-mini",
  "total_results": 15,
  "reranked_results": 5,
  "execution_id": "call_zIsjIkJwvPrJTz2GbIRGg8DE"
}

​

Champs de Réponse

​

Exemple d’Utilisation

​

Recherche Basique

{
  "query": "prix actuel du bitcoin"
}

​

Recherche Filtrée par Temps

{
  "query": "tremblement de terre au japon",
  "time_range": "day"
}

​

Liste Blanche et Liste Noire de Domaines

​

1. Liste Blanche Stricte (Niveau de l’Outil)

• Si un domaine en liste blanche est fourni, l’outil renverra uniquement les résultats de ce domaine spécifique.
• Si le moteur de recherche ne trouve aucun résultat provenant du domaine en liste blanche, aucun résultat ne sera affiché à l’agent.
• C’est idéal lorsque vous voulez garantir absolument que l’agent n’utilise que des informations provenant d’une source spécifique et de confiance (par exemple, la documentation de votre propre entreprise).

​

2. Contrôle Granulaire et Score Bonus (Navigateur Sécurisé Auto-hébergé)

• Domaines en Liste Blanche (Niveau Navigateur) : Le moteur de recherche priorisera activement et donnera un bonus aux résultats de ces domaines, mais il renverra quand même d’autres résultats pertinents si les domaines de confiance n’ont pas la réponse.
• Domaines en Liste Noire : Le moteur de recherche filtrera complètement les résultats de ces domaines (par exemple, pour bloquer les spams connus ou les sites concurrents).

​

Comment Ça Marche

1. Recherche : L’outil interroge un moteur de recherche pour obtenir un large ensemble de résultats initiaux.
2. Scraping : Il visite les meilleures URL pour extraire le contenu textuel complet, pas seulement l’extrait de recherche.
3. Rerank : Un modèle spécialisé de “reranker” compare la requête de l’utilisateur au texte complet de chaque page pour déterminer lesquelles sont vraiment pertinentes. 4. Générer : Les morceaux de texte les plus pertinents sont passés à un LLM, qui synthétise la réponse finale et ajoute des citations.

​

Événements de Streaming

​

Types d’Événements

​

Phases du Pipeline (tool_update)

1. WEB_SEARCH
   • status: started / completed
   • data: { "results_count": <int>, "sources": [...] } (à la fin)
   • Indique la requête initiale au moteur de recherche. Le tableau sources contient les résultats bruts de la recherche :
     // Exemple de structure 'sources' dans la phase WEB_SEARCH
     [
       {
         "rank": 1,
         "title": "Recent Advances in AI",
         "url": "https://example.com/ai-news",
         "snippet": "A summary of the latest breakthroughs...",
         "engine": "google",
         "score": 1.0
       }
     ]
     
2. SCRAPING_URLS

• status: started / completed
• data: { "url_count": <int> } (au début), { "scraped_count": <int> } (à la fin)
• Indique la récupération du contenu textuel complet à partir des meilleures URL.
• Fonctionnalité AvancéeLe scraping du contenu complet de la page est une fonctionnalité avancée et est désactivé par défaut. Lorsqu’il est désactivé, l’outil s’appuie uniquement sur les extraits du moteur de recherche. Si vous souhaitez activer le scraping complet des pages pour votre espace de travail, veuillez contacter l’équipe UBIK à contact@ubik-agent.com.

3. RERANKING
   • status: started / completed
   • data: { "reranked_count": <int> } (à la fin). Note : Le tableau sources affiné est émis dans un événement tool_update séparé juste après.
   • Indique que les résultats ont été reclassés par pertinence sémantique. Une fois cette phase terminée, des événements tool_update supplémentaires sont émis contenant le nombre final reranked_results et le tableau affiné sources avec les scores sémantiques :
     // Exemple de structure 'sources' après la phase RERANKING
     [
       {
         "rank": 1,
         "title": "Recent Advances in AI",
         "url": "https://example.com/ai-news",
         "snippet": "A summary of the latest breakthroughs...",
         "rerank_score": 0.85,
         "used_in_response": false
       }
     ]
     
4. GENERATION
   • status: started / completed
   • Indique que la génération LLM de la réponse finale commence.

​

Streaming de Contenu (tool_partial_update)

• content: <string> (Le fragment de texte)
• output_key: "response"

​

Exemple de Flux d’Événements

// Début de la Recherche Web
{ "event": "tool_update", "data": { "phase": "WEB_SEARCH", "status": "started", "query": "dernières avancées en IA" } }

// Recherche Web terminée
{ "event": "tool_update", "data": { "phase": "WEB_SEARCH", "status": "completed", "data": { "results_count": 10, "sources": [...] }, "output_key": "sources" } }

// Début du Scraping
{ "event": "tool_update", "data": { "phase": "SCRAPING_URLS", "status": "started", "data": { "url_count": 10 } } }

// Scraping terminé
{ "event": "tool_update", "data": { "phase": "SCRAPING_URLS", "status": "completed", "data": { "scraped_count": 8 } } }

// Début du Reranking
{ "event": "tool_update", "data": { "phase": "RERANKING", "status": "started" } }

// Reranking terminé
{ "event": "tool_update", "data": { "phase": "RERANKING", "status": "completed", "data": { "reranked_count": 8 } } }

// Sources finales émises
{ "event": "tool_update", "data": { "reranked_results": 5, "output_key": "reranked_results" } }
{ "event": "tool_update", "data": { "sources": [...], "output_key": "sources" } }

// Début de la Génération
{ "event": "tool_update", "data": { "phase": "GENERATION", "status": "started" } }

// Streaming de la réponse (tool_partial_update)
{ "event": "tool_partial_update", "data": { "content": "Selon", "output_key": "response" } }
{ "event": "tool_partial_update", "data": { "content": " les", "output_key": "response" } }
{ "event": "tool_partial_update", "data": { "content": " résultats <source_1>...", "output_key": "response" } }

// Génération terminée
{ "event": "tool_update", "data": { "phase": "GENERATION", "status": "completed" } }

// Fin
{ 
  "event": "tool_end", 
  "data": { 
    "query": "dernières avancées en IA",
    "response": "Selon les résultats <web_citation url=\"...\">[1]</web_citation>...",
    "sources": [
      {
        "rank": 1,
        "title": "Recent Advances in AI",
        "url": "https://example.com/ai-news",
        "snippet": "A summary of the latest breakthroughs...",
        "rerank_score": 0.85,
        "used_in_response": true
      }
    ],
    "sources_used": [1],
    "model": "claude-sonnet-4-20250514",
    "reranker": "bge_text_reranker",
    "total_results": 10,
    "reranked_results": 5
  } 
}