Citations et sources automatiques

Traçabilité des informations

L’un des avantages majeurs de Web Search par rapport à une simple génération de texte est la traçabilité. Quand le modèle utilise des informations provenant d’une recherche web, l’API retourne automatiquement les citations avec les URLs des sources consultées. Cela vous permet de vérifier les informations et de les présenter avec leurs références dans votre application.

Fonctionnement des citations

Les citations sont générées automatiquement par l’API sans aucune configuration de votre part. Dès que Web Search est activé et que le modèle utilise des résultats de recherche dans sa réponse, les sources sont incluses dans l’objet de réponse.

Les citations sont accessibles via le champ citations de la réponse. Chaque citation contient l’URL de la source et le contexte dans lequel elle a été utilisée.

Exploiter les citations dans votre application

Afficher les sources

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Quelles sont les dernières avancées en calcul quantique ?",
    tools=[{"type": "web_search"}]
)

# Afficher la réponse
print(response.output_text)

# Afficher les citations
if hasattr(response, 'citations') and response.citations:
    print("\nSources :")
    for citation in response.citations:
        print(f"  - {citation.url}")

Intégrer les sources dans une interface utilisateur

Dans une application web, vous pouvez transformer les citations en liens cliquables. Cela renforce la crédibilité de votre application et permet à l’utilisateur final de vérifier les informations.

def format_response_with_sources(response):
    output = response.output_text

    if hasattr(response, 'citations') and response.citations:
        output += "\n\n---\n**Sources :**\n"
        for i, citation in enumerate(response.citations, 1):
            output += f"{i}. [{citation.url}]({citation.url})\n"

    return output

Cas d’usage des citations

Chatbots d’entreprise

Pour un assistant IA destiné à vos clients, les citations apportent de la transparence. L’utilisateur peut vérifier que l’information provient d’une source fiable, ce qui augmente la confiance dans les réponses.

Applications de veille

Dans un outil de veille automatisée, les citations sont essentielles pour tracer l’origine des informations. Elles permettent d’associer chaque insight à sa source et de faciliter l’analyse approfondie.

Génération de rapports

Si vous utilisez l’API pour générer des rapports automatiques, les citations servent de bibliographie. Elles documentent les sources utilisées et renforcent la rigueur du rapport.

Combiner citations et filtrage de domaines

En combinant allowed_domains avec les citations, vous obtenez un système de recherche contrôlé et traçable :

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="État actuel de la réglementation IA en Europe",
    tools=[{
        "type": "web_search",
        "allowed_domains": [
            "ec.europa.eu",
            "eur-lex.europa.eu",
            "legifrance.gouv.fr"
        ]
    }]
)

Les citations confirmeront que les informations proviennent exclusivement des sources autorisées.

Limites à connaître

• Les citations ne sont pas toujours présentes : si le modèle répond sans utiliser les résultats de recherche, aucune citation n’est générée
• Le format exact des citations peut varier selon le SDK utilisé
• Les citations référencent les pages consultées, pas nécessairement les passages exacts utilisés
• Le nombre de citations dépend du nombre de sources que le modèle a effectivement utilisées

Points clés à retenir

• Les citations sont automatiques : aucune configuration nécessaire
• Elles sont accessibles via le champ citations de la réponse
• Les citations apportent traçabilité et crédibilité à votre application
• Elles se combinent avec le filtrage de domaines pour un contrôle total
• Intégrez-les dans votre interface pour permettre la vérification des sources