Share via

API di creazione

  • Articolo

L'API di creazione delle domande viene usata per automatizzare attività comuni, ad esempio l'aggiunta di nuove coppie di risposte alle domande, nonché la creazione, la pubblicazione e la gestione di progetti.

Nota

La funzionalità di creazione è disponibile tramite l'API REST e Authoring SDK (anteprima). Questo articolo fornisce esempi di uso dell'API REST con cURL. Per la documentazione completa di tutti i parametri e le funzionalità disponibili, vedere il contenuto di riferimento dell'API REST.

Prerequisiti

  • La versione corrente di cURL. In questo articolo vengono usate diverse opzioni della riga di comando, indicate nella documentazione di cURL.
  • I comandi in questo articolo sono progettati per essere eseguiti in una shell Bash. Questi comandi non funzioneranno sempre in un prompt dei comandi di Windows o in PowerShell senza modifiche. Se non è installata una shell Bash in locale, è possibile usare l'ambiente bash di Azure Cloud Shell.

Creare un progetto

Per creare un progetto a livello di codice:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project Get prediction URL (Distribuisci l'URL di previsione del progetto).> Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se l'esempio precedente è l'endpoint nell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project Get prediction URL (Distribuisci l'URL di previsione del progetto).> Il valore della chiave fa parte della richiesta di esempio.
NEW-PROJECT-NAME Nome del nuovo progetto di risposte alle domande.

È anche possibile modificare valori aggiuntivi come la lingua del progetto, la risposta predefinita data quando non è possibile trovare risposte che soddisfano o superano la soglia di attendibilità e se questa risorsa di lingua supporterà più lingue.

Query di esempio

curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
      "description": "proj1 is a test project.",
      "language": "en",
      "settings": {
        "defaultAnswer": "No good match found for your question in the project."
      },
      "multilingualResource": true
    }
  }'  'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{NEW-PROJECT-NAME}?api-version=2021-10-01'

Esempio di risposta

{
 "200": {
      "headers": {},
      "body": {
        "projectName": "proj1",
        "description": "proj1 is a test project.",
        "language": "en",
        "settings": {
          "defaultAnswer": "No good match found for your question in the project."
        },
        "multilingualResource": true,
        "createdDateTime": "2021-05-01T15:13:22Z",
        "lastModifiedDateTime": "2021-05-01T15:13:22Z",
        "lastDeployedDateTime": "2021-05-01T15:13:22Z"
      }
 }
}

Elimina il progetto

Per eliminare un progetto a livello di codice:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se l'esempio precedente è l'endpoint nell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto da eliminare.

Query di esempio

curl -X DELETE -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}?api-version=2021-10-01'

Una chiamata riuscita per eliminare un progetto comporta la restituzione di un'intestazione Operation-Location , che può essere usata per controllare lo stato del processo di eliminazione del progetto. Nella maggior parte degli esempi non è necessario esaminare le intestazioni di risposta e quindi non sono state visualizzate. Per recuperare le intestazioni di risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta a questo comando apparirebbe vuota come se non si fosse verificata alcuna risposta.

Esempio di risposta

HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deletion-jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 324
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Tue, 23 Nov 2021 20:56:18 GMT

Se il progetto è già stato eliminato o non è stato trovato, verrà visualizzato un messaggio simile al seguente:

{
  "error": {
    "code": "ProjectNotFound",
    "message": "The specified project was not found.",
    "details": [
      {
        "code": "ProjectNotFound",
        "message": "{GUID}"
      }
    ]
  }
}

Ottenere lo stato di eliminazione del progetto

Per verificare lo stato della richiesta di eliminazione del progetto:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project Get prediction URL (Distribuisci l'URL di previsione del progetto).> Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui si vuole verificare lo stato della distribuzione.
JOB-ID Quando si elimina un progetto a livello di codice, un JOB-ID viene generato come parte dell'intestazione operation-location della risposta alla richiesta di eliminazione. JOB-ID è il GUID alla fine dell'oggetto operation-location. Ad esempio: operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deletion-jobs/{THIS GUID IS YOUR JOB ID}

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/deletion-jobs/{JOB-ID}?api-version=2021-10-01'

Esempio di risposta

{
  "createdDateTime": "2021-11-23T20:56:18+00:00",
  "expirationDateTime": "2021-11-24T02:56:18+00:00",
  "jobId": "GUID",
  "lastUpdatedDateTime": "2021-11-23T20:56:18+00:00",
  "status": "succeeded"
}

Ottenere le impostazioni del progetto

Per recuperare informazioni su un determinato progetto, aggiornare i valori seguenti nella query seguente:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto su cui recuperare informazioni.

Query di esempio


curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}?api-version=2021-10-01'

Esempio di risposta

 {
    "200": {
      "headers": {},
      "body": {
        "projectName": "proj1",
        "description": "proj1 is a test project.",
        "language": "en",
        "settings": {
          "defaultAnswer": "No good match found for your question in the project."
        },
        "createdDateTime": "2021-05-01T15:13:22Z",
        "lastModifiedDateTime": "2021-05-01T15:13:22Z",
        "lastDeployedDateTime": "2021-05-01T15:13:22Z"
      }
    }
  }

Ottenere coppie di risposte alle domande

Per recuperare le coppie di risposte alle domande e le informazioni correlate per un determinato progetto, aggiornare i valori seguenti nella query seguente:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui recuperare tutte le coppie di risposte alle domande.

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/qnas?api-version=2021-10-01'

Esempio di risposta

{
    "200": {
      "headers": {},
      "body": {
        "value": [
          {
            "id": 1,
            "answer": "ans1",
            "source": "source1",
            "questions": [
              "question 1.1",
              "question 1.2"
            ],
            "metadata": {
              "k1": "v1",
              "k2": "v2"
            },
            "dialog": {
              "isContextOnly": false,
              "prompts": [
                {
                  "displayOrder": 1,
                  "qnaId": 11,
                  "displayText": "prompt 1.1"
                },
                {
                  "displayOrder": 2,
                  "qnaId": 21,
                  "displayText": "prompt 1.2"
                }
              ]
            },
            "lastUpdatedDateTime": "2021-05-01T17:21:14Z"
          },
          {
            "id": 2,
            "answer": "ans2",
            "source": "source2",
            "questions": [
              "question 2.1",
              "question 2.2"
            ],
            "lastUpdatedDateTime": "2021-05-01T17:21:14Z"
          }
        ]
      }
    }
  }

Recupera origini

Per recuperare le origini e le informazioni correlate per un determinato progetto, aggiornare i valori seguenti nella query seguente:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui recuperare tutte le informazioni di origine.

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT_NAME}/sources?api-version=2021-10-01'

Esempio di risposta

{
    "200": {
      "headers": {},
      "body": {
        "value": [
          {
            "displayName": "source1",
            "sourceUri": "https://learn.microsoft.com/azure/ai-services/qnamaker/overview/overview",
            "sourceKind": "url",
            "lastUpdatedDateTime": "2021-05-01T15:13:22Z"
          },
          {
            "displayName": "source2",
            "sourceUri": "https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf",
            "sourceKind": "file",
            "contentStructureKind": "unstructured",
            "lastUpdatedDateTime": "2021-05-01T15:13:22Z"
          }
        ]
      }
    }
  }

Ottenere sinonimi

Per recuperare sinonimi e informazioni correlate per un determinato progetto, aggiornare i valori seguenti nella query seguente:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui si desidera recuperare le informazioni sui sinonimi.

Query di esempio


curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/synonyms?api-version=2021-10-01'

Esempio di risposta

 {
    "200": {
      "headers": {},
      "body": {
        "value": [
          {
            "alterations": [
              "qnamaker",
              "qna maker"
            ]
          },
          {
            "alterations": [
              "botframework",
              "bot framework"
            ]
          }
        ]
      }
    }
  }

Distribuzione del progetto

Per distribuire un progetto nell'ambiente di produzione, aggiornare i valori seguenti nella query seguente:

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto da distribuire nell'ambiente di produzione.

Query di esempio

curl -X PUT -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/deployments/production?api-version=2021-10-01'

Una chiamata riuscita per distribuire un progetto comporta la restituzione di un'intestazione Operation-Location che può essere usata per controllare lo stato del processo di distribuzione. Nella maggior parte degli esempi non è necessario esaminare le intestazioni di risposta e quindi non sono state visualizzate. Per recuperare le intestazioni di risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta a questo comando apparirebbe vuota come se non si fosse verificata alcuna risposta.

Esempio di risposta

0HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deployments/production/jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 31
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Tue, 23 Nov 2021 20:35:00 GMT

Ottenere lo stato di distribuzione del progetto

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui si vuole verificare lo stato della distribuzione.
JOB-ID Quando si distribuisce un progetto a livello di codice, un JOB-ID viene generato come parte dell'intestazione operation-location della risposta alla richiesta di distribuzione. JOB-ID è il GUID alla fine dell'oggetto operation-location. Ad esempio: operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deployments/production/jobs/{THIS GUID IS YOUR JOB ID}

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/deployments/production/jobs/{JOB-ID}?api-version=2021-10-01'

Esempio di risposta

    {
    "200": {
      "headers": {},
      "body": {
        "errors": [],
        "createdDateTime": "2021-05-01T17:21:14Z",
        "expirationDateTime": "2021-05-01T17:21:14Z",
        "jobId": "{JOB-ID-GUID}",
        "lastUpdatedDateTime": "2021-05-01T17:21:14Z",
        "status": "succeeded"
      }
    }
  }

Esportare i metadati e gli asset del progetto

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto da esportare.

Query di esempio

curl -X POST -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{exportAssetTypes": ["qnas","synonyms"]}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/:export?api-version=2021-10-01&format=tsv'

Esempio di risposta

HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/Sample-project/export/jobs/{JOB-ID_GUID}
x-envoy-upstream-service-time: 214
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Tue, 23 Nov 2021 21:24:03 GMT

Controllare lo stato dell'esportazione

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui si vuole verificare lo stato dell'esportazione.
JOB-ID Quando si esporta un progetto a livello di codice, un JOB-ID viene generato come parte dell'intestazione operation-location della risposta alla richiesta di esportazione. JOB-ID è il GUID alla fine dell'oggetto operation-location. Ad esempio: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/export/jobs/{THIS GUID IS YOUR JOB ID}

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID}?api-version=2021-10-01'

Esempio di risposta

{
  "createdDateTime": "2021-11-23T21:24:03+00:00",
  "expirationDateTime": "2021-11-24T03:24:03+00:00",
  "jobId": "JOB-ID-GUID",
  "lastUpdatedDateTime": "2021-11-23T21:24:08+00:00",
  "status": "succeeded",
  "resultUrl": "https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result"
}

Se si tenta di accedere direttamente a resultUrl, verrà visualizzato un errore 404. È necessario aggiungere ?api-version=2021-10-01 al percorso per renderlo accessibile da una richiesta autenticata: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result?api-version=2021-10-01

Importare il progetto

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si desidera essere la destinazione per l'importazione.
FILE-URI-PATH Quando si esporta un progetto a livello di codice e quindi si controlla lo stato in cui l'esportazione viene resultUrl generata come parte della risposta. Ad esempio: "resultUrl": "https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result" è possibile usare resultUrl con la versione dell'API aggiunta come file di origine per importare un progetto da: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result?api-version=2021-10-01.

Query di esempio

curl -X POST -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
      "fileUri": "FILE-URI-PATH"
  }' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/:import?api-version=2021-10-01&format=tsv'

Una chiamata riuscita per importare un progetto comporta la restituzione di un'intestazione Operation-Location , che può essere usata per controllare lo stato del processo di importazione. In molti degli esempi non è necessario esaminare le intestazioni di risposta e quindi non sono state visualizzate. Per recuperare le intestazioni di risposta, il comando curl usa -i. Senza questo parametro aggiuntivo prima dell'indirizzo dell'endpoint, la risposta a questo comando apparirebbe vuota come se non si fosse verificata alcuna risposta.

Esempio di risposta

HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/import/jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 417
apim-request-id: 
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 00:35:11 GMT

Controllare lo stato dell'importazione

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si desidera essere la destinazione per l'importazione.
JOB-ID Quando si importa un progetto a livello di codice, un JOB-ID viene generato come parte dell'intestazione operation-location della risposta alla richiesta di esportazione. JOB-ID è il GUID alla fine di operation-location. Ad esempio: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/import/jobs/{THIS GUID IS YOUR JOB ID}

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME/import/jobs/{JOB-ID-GUID}?api-version=2021-10-01'

Risposta di query di esempio

{
  "errors": [],
  "createdDateTime": "2021-05-01T17:21:14Z",
  "expirationDateTime": "2021-05-01T17:21:14Z",
  "jobId": "JOB-ID-GUID",
  "lastUpdatedDateTime": "2021-05-01T17:21:14Z",
  "status": "succeeded"
}

Elencare distribuzioni

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto per cui si vuole generare un elenco di distribuzione.

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/deployments?api-version=2021-10-01'

Esempio di risposta

[
  {
    "deploymentName": "production",
    "lastDeployedDateTime": "2021-10-26T15:12:02Z"
  }
]

Elencare i progetti

Recuperare un elenco di tutti i progetti di risposta alle domande a cui l'account ha accesso.

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects?api-version=2021-10-01'

Esempio di risposta

{
  "value": [
    {
      "projectName": "Sample-project",
      "description": "My first question answering project",
      "language": "en",
      "multilingualResource": false,
      "createdDateTime": "2021-10-07T04:51:15Z",
      "lastModifiedDateTime": "2021-10-27T00:42:01Z",
      "lastDeployedDateTime": "2021-11-24T01:34:18Z",
      "settings": {
        "defaultAnswer": "No good match found in KB"
      }
    }
  ]
}

Aggiornare le origini

In questo esempio verrà aggiunta una nuova origine a un progetto esistente. È anche possibile sostituire ed eliminare le origini esistenti con questo comando a seconda del tipo di operazioni passate come parte del corpo della query.

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto in cui si desidera aggiornare le origini.
METHOD PATCH

Query di esempio

curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '[
  {
    "op": "add",
    "value": {
      "displayName": "source5",
      "sourceKind": "url",
      "sourceUri": "https://download.microsoft.com/download/7/B/1/7B10C82E-F520-4080-8516-5CF0D803EEE0/surface-book-user-guide-EN.pdf",
      "sourceContentStructureKind": "semistructured"
    }
  }
]'  -i '{LanguageServiceName}.cognitiveservices.azure.com//language/query-knowledgebases/projects/{projectName}/sources?api-version=2021-10-01'

Una chiamata riuscita per aggiornare un'origine comporta la restituzione di un'intestazione Operation-Location che può essere usata per controllare lo stato del processo di importazione. In molti degli esempi non è necessario esaminare le intestazioni di risposta e quindi non sono sempre state visualizzate. Per recuperare le intestazioni di risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta a questo comando apparirebbe vuota come se non si fosse verificata alcuna risposta.

Esempio di risposta

HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/Sample-project/sources/jobs/{JOB_ID_GUID}
x-envoy-upstream-service-time: 412
apim-request-id: dda23d2b-f110-4645-8bce-1a6f8d504b33
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 02:47:53 GMT

Ottenere lo stato dell'origine dell'aggiornamento

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project Get prediction URL (Distribuisci l'URL di previsione del progetto).> Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si desidera essere la destinazione per l'importazione.
JOB-ID Quando si aggiorna un'origine a livello di codice, un JOB-ID viene generato come parte dell'intestazione della risposta alla richiesta di origine dell'aggiornamento operation-location . JOB-ID è il GUID alla fine di operation-location. Ad esempio: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/sources/jobs/{THIS GUID IS YOUR JOB ID}

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/sources/jobs/{JOB-ID}?api-version=2021-10-01'

Esempio di risposta

{
  "createdDateTime": "2021-11-24T02:47:53+00:00",
  "expirationDateTime": "2021-11-24T08:47:53+00:00",
  "jobId": "{JOB-ID-GUID}",
  "lastUpdatedDateTime": "2021-11-24T02:47:56+00:00",
  "status": "succeeded",
  "resultUrl": "/knowledgebases/Sample-project"
}

Aggiornare le coppie di domande e risposte

In questo esempio si aggiungerà una coppia di risposte alle domande a un'origine esistente. È anche possibile modificare o eliminare coppie di risposte alle domande esistenti con questa query a seconda dell'operazione passata nel corpo della query. Se non si dispone di un'origine denominata source5, questa query di esempio avrà esito negativo. È possibile modificare il valore di origine nel corpo della query in un'origine esistente per il progetto di destinazione.

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si desidera essere la destinazione per l'importazione. 
curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '[
    {
        "op": "add",
        "value":{
            "id": 1,
            "answer": "The latest question answering docs are on https://learn.microsoft.com",
            "source": "source5",
            "questions": [
                "Where do I find docs for question answering?"
            ],
            "metadata": {},
            "dialog": {
                "isContextOnly": false,
                "prompts": []
            }
        }
    }
]'  -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/qnas?api-version=2021-10-01'

Una chiamata riuscita per aggiornare una coppia di risposte alla domanda comporta la restituzione di un'intestazione Operation-Location che può essere usata per controllare lo stato del processo di aggiornamento. In molti degli esempi non è necessario esaminare le intestazioni di risposta e quindi non sono sempre state visualizzate. Per recuperare le intestazioni di risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta a questo comando apparirebbe vuota come se non si fosse verificata alcuna risposta.

Esempio di risposta

HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/Sample-project/qnas/jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 507
apim-request-id: 
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 03:16:01 GMT

Ottenere lo stato delle coppie di risposte alle domande di aggiornamento

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si vuole essere la destinazione per gli aggiornamenti delle coppie di risposte alle domande.
JOB-ID Quando si aggiorna una coppia di risposte alle domande a livello di codice, un JOB-ID viene generato come parte dell'intestazione operation-location della risposta alla richiesta di aggiornamento. JOB-ID è il GUID alla fine di operation-location. Ad esempio: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/qnas/jobs/{THIS GUID IS YOUR JOB ID}

Query di esempio

curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/qnas/jobs/{JOB-ID}?api-version=2021-10-01'

Esempio di risposta

  "createdDateTime": "2021-11-24T03:16:01+00:00",
  "expirationDateTime": "2021-11-24T09:16:01+00:00",
  "jobId": "{JOB-ID-GUID}",
  "lastUpdatedDateTime": "2021-11-24T03:16:06+00:00",
  "status": "succeeded",
  "resultUrl": "/knowledgebases/Sample-project"

Aggiornare i sinonimi

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si vuole aggiungere sinonimi.

Query di esempio

curl -X PUT -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
"value": [
    {
      "alterations": [
        "qnamaker",
        "qna maker"
      ]
    },
    {
      "alterations": [
        "botframework",
        "bot framework"
      ]
    }
  ]
}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/synonyms?api-version=2021-10-01'

Esempio di risposta

0HTTP/2 200
content-length: 17
content-type: application/json; charset=utf-8
x-envoy-upstream-service-time: 39
apim-request-id: 5deb2692-dac8-43a8-82fe-36476e407ef6
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 03:59:09 GMT

{
  "value": []
}

Aggiornare i commenti e suggerimenti per l'apprendimento attivo

Nome variabile Valore
ENDPOINT Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se si tratta dell'endpoint nell'esempio di codice riportato di seguito, è sufficiente aggiungere la parte specifica dell'area di southcentral come il resto del percorso dell'endpoint è già presente.
API-KEY Questo valore è disponibile nella sezione Chiavi &ed endpoint durante l'esame della risorsa dalla portale di Azure. È possibile usare Key1 o Key2. Avere sempre due chiavi valide consente la rotazione sicura delle chiavi con tempi di inattività zero. In alternativa, è possibile trovare il valore in Language Studio>question answering>Deploy project>Get prediction URL (Distribuisci progetto Get prediction URL). Il valore della chiave fa parte della richiesta di esempio.
PROJECT-NAME Nome del progetto che si vuole essere la destinazione per gli aggiornamenti del feedback sull'apprendimento attivo.

Query di esempio

curl -X POST -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
records": [
    {
      "userId": "user1",
      "userQuestion": "hi",
      "qnaId": 1
    },
    {
      "userId": "user1",
      "userQuestion": "hello",
      "qnaId": 2
    }
  ]
}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/feedback?api-version=2021-10-01'

Esempio di risposta

HTTP/2 204
x-envoy-upstream-service-time: 37
apim-request-id: 92225e03-e83f-4c7f-b35a-223b1b0f29dd
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 04:02:56 GMT