Répondre aux requêtes avec la génération ancrée

Utilisez la méthode AnswerQuery pour obtenir des réponses aux requêtes ancrées dans le corpus de connaissances pour les développeurs.

Avant de commencer

Assurez-vous d'avoir activé l'API et généré une clé API Developer Knowledge, puis enregistrez votre clé dans une variable d'environnement :

export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"

Exemple d'utilisation

L'exemple suivant pose la question "Comment créer un ensemble de données BigQuery ?" :

curl -X POST "https://developerknowledge.googleapis.com/v1alpha:answerQuery?key=$DEVELOPERKNOWLEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I create a BigQuery dataset?"}'

La réponse contient la réponse textuelle dans le champ answer.answer_text, ainsi que citations et references dans l'objet answer :

{
  "answer": {
    "answerText": "To create a BigQuery dataset, you can use the Google Cloud Console, the bq command-line tool, or the BigQuery client libraries.",
    "citations": [
      {
        "startIndex": 0,
        "endIndex": 123,
        "sources": [
          {
            "referenceIndex": 0
          }
        ]
      }
    ],
    "references": [
      {
        "documentReference": {
          "documentChunk": {
            "parent": "documents/cloud.google.com/bigquery/docs/datasets",
            "content": "This page explains how to create BigQuery datasets...",
            "document": {
              "name": "documents/cloud.google.com/bigquery/docs/datasets",
              "title": "Introduction to datasets",
              "uri": "https://cloud.google.com/bigquery/docs/datasets"
            }
          }
        }
      }
    ]
  }
}