API di creazione

Articolo
09/04/2024

L'API di creazione di risposta alla domanda personalizzata consente di automatizzare attività comuni come l'aggiunta di nuove coppie di domande e risposte e 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 utilizzo dell'API REST con cURL. Per la documentazione completa di tutti i parametri e le funzionalità disponibili, vedere il contenuto di riferimento per l'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 illustrati in questo articolo sono progettati per essere eseguiti in una shell Bash e non sempre funzionano in un prompt dei comandi di Windows o in un'istanza di PowerShell senza essere modificati. Se non si dispone di una shell Bash installata 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>Risposta alle domande>Distribuisci il progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se l'esempio precedente riguardava l'endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>Risposta alle domande>Distribuisci il progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`NEW-PROJECT-NAME`	Il nome del nuovo progetto di risposta alla domanda personalizzata.

È anche possibile modificare altri valori come la lingua del progetto, la risposta predefinita fornita quando non si trovano 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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se l'esempio precedente riguardava l'endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera 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'

Se una chiamata di eliminazione di un progetto è corretta, viene restituita un'intestazione Operation-Location, che consente di controllare lo stato del processo di eliminazione del progetto. Nella maggior parte degli esempi, non è stato necessario guardare le intestazioni di risposta, che non sono state quindi visualizzate. Per recuperare le intestazioni della risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta al comando risulterebbe vuota come se non fosse stata inviata 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 era 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>Risposta alle domande>Distribuisci il progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si vuole verificare lo stato di distribuzione.
`JOB-ID`	Quando si elimina un progetto a livello di codice, viene generato un `JOB-ID` all'interno dell'intestazione della risposta `operation-location` alla richiesta di eliminazione. `JOB-ID` è il GUID alla fine dell'intestazione `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 riportata di seguito:

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si desidera 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 domanda e risposta

Per recuperare coppie di domanda e risposta e relative informazioni su un determinato progetto, aggiornare i valori seguenti nella query riportata di seguito:

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si desidera recuperare tutte le coppie di domande e risposte.

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 relative informazioni su un determinato progetto, aggiornare i valori seguenti nella query riportata di seguito:

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si desidera recuperare informazioni su tutte le origini.

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://video2.skills-academy.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 i sinonimi e relative informazioni su un determinato progetto, aggiornare i valori seguenti nella query riportata di seguito:

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si desidera recuperare 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 riportata di seguito:

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera 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'

Se una chiamata di distribuzione di un progetto è corretta, viene restituita un'intestazione Operation-Location, che consente di controllare lo stato del processo di distribuzione. Nella maggior parte degli esempi, non è stato necessario guardare le intestazioni di risposta, che non sono state quindi visualizzate. Per recuperare le intestazioni della risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta al comando risulterebbe vuota come se non fosse stata inviata 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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si vuole verificare lo stato di distribuzione.
`JOB-ID`	Quando si distribuisce un progetto a livello di codice, viene generato un `JOB-ID` all'interno dell'intestazione della risposta `operation-location` alla richiesta di distribuzione. `JOB-ID` è il GUID alla fine dell'intestazione `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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera 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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto di cui si vuole verificare lo stato di esportazione.
`JOB-ID`	Quando si esporta un progetto a livello di codice, viene generato un `JOB-ID` all'interno dell'intestazione della risposta `operation-location` alla richiesta di esportazione. `JOB-ID` è il GUID alla fine dell'intestazione `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 al resultUrl, verrà restituito l'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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera impostare come destinazione dell'importazione.
`FILE-URI-PATH`	Quando si esporta un progetto a livello di codice e poi si verifica lo stato del processo di esportazione, viene generato un `resultUrl` all'interno 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 il 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'

Se una chiamata di importazione di un progetto è corretta, viene restituita un'intestazione Operation-Location, che consente di controllare lo stato del processo di importazione. Nella maggior parte degli esempi, non è stato necessario guardare le intestazioni di risposta, che non sono state quindi visualizzate. Per recuperare le intestazioni della risposta, il comando curl usa -i. Senza questo parametro aggiuntivo prima dell'indirizzo dell'endpoint, la risposta al comando risulterebbe vuota come se non fosse stata inviata 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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera impostare come destinazione dell'importazione.
`JOB-ID`	Quando si importa un progetto a livello di codice, viene generato un `JOB-ID` all'interno dell'intestazione della risposta `operation-location` alla richiesta di esportazione. `JOB-ID` è il GUID alla fine dell'intestazione `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 a una 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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto per cui si desidera 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 progetti

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

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: https://southcentralus.api.cognitive.microsoft.com/. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di southcentral poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. 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. Con questo comando è anche possibile sostituire ed eliminare origini esistenti, in base al tipo di operazioni passate nel 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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il 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'

Se una chiamata di aggiornamento di un'origine è corretta, viene restituita un'intestazione Operation-Location, che consente di controllare lo stato del processo di importazione. Nella maggior parte degli esempi, non è stato necessario guardare le intestazioni di risposta, che in alcuni casi non sono state quindi visualizzate. Per recuperare le intestazioni della risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta al comando risulterebbe vuota come se non fosse stata inviata 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 del processo di aggiornamento dell'origine

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>Risposta alle domande>Distribuisci il progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera impostare come destinazione dell'importazione.
`JOB-ID`	Quando si aggiorna un'origine a livello di codice, viene generato un `JOB-ID` all'interno dell'intestazione della risposta `operation-location` alla richiesta di aggiornamento dell'origine. `JOB-ID` è il GUID alla fine dell'intestazione `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 coppie di domande e risposte

In questo esempio si aggiungerà una coppia di domanda e risposta a un'origine esistente. Con questa query è anche possibile modificare o eliminare coppie di domande e risposte esistenti, 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 dell'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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera impostare come destinazione dell'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://video2.skills-academy.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'

Se una chiamata di aggiornamento di una coppia di domanda e risposta è corretta, viene restituita un'intestazione Operation-Location, che consente di controllare lo stato del processo di aggiornamento. Nella maggior parte degli esempi, non è stato necessario guardare le intestazioni di risposta, che in alcuni casi non sono state quindi visualizzate. Per recuperare le intestazioni della risposta, il comando curl usa -i. Senza questo parametro prima dell'indirizzo dell'endpoint, la risposta al comando risulterebbe vuota come se non fosse stata inviata 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 del processo di aggiornamento di coppie di domande e risposte

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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera impostare come destinazione degli aggiornamenti delle coppie di domande e risposte.
`JOB-ID`	Quando si aggiorna una coppia di domanda e risposta a livello di codice, viene generato un `JOB-ID` all'interno dell'intestazione della risposta `operation-location` alla richiesta di aggiornamento. `JOB-ID` è il GUID alla fine dell'intestazione `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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto in cui si desidera 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 il feedback sull'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>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Un endpoint di esempio è: `https://southcentralus.api.cognitive.microsoft.com/`. Se questo è lo stesso endpoint dell'esempio di codice seguente, è sufficiente aggiungere la parte specifica dell'area di `southcentral` poiché la parte restare del percorso di 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. La costante disponibilità di due chiavi valide consente la rotazione sicura delle chiavi senza tempi di inattività. In alternativa, è possibile trovare il valore in Language Studio>risposta alla domanda>Distribuisci progetto>Ottieni URL di previsione. Il valore della chiave fa parte della richiesta di esempio.
`PROJECT-NAME`	Il nome del progetto che si desidera impostare come destinazione degli aggiornamenti al feedback di 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

Condividi tramite

API di creazione

Prerequisiti

Creare un progetto

Query di esempio

Esempio di risposta

Elimina il progetto

Query di esempio

Esempio di risposta

Ottenere lo stato di eliminazione del progetto

Query di esempio

Esempio di risposta

Ottenere le impostazioni del progetto

Query di esempio

Esempio di risposta

Ottenere coppie di domanda e risposta

Query di esempio

Esempio di risposta

Recupera origini

Query di esempio

Esempio di risposta

Ottenere sinonimi

Query di esempio

Esempio di risposta

Distribuzione del progetto

Query di esempio

Esempio di risposta

Ottenere lo stato di distribuzione del progetto

Query di esempio

Esempio di risposta

Esportare i metadati e gli asset del progetto

Query di esempio

Esempio di risposta

Controllare lo stato dell'esportazione

Query di esempio

Esempio di risposta

Importare il progetto

Query di esempio

Esempio di risposta

Controllare lo stato dell'importazione

Query di esempio

Risposta a una query di esempio

Elencare distribuzioni

Query di esempio

Esempio di risposta

Elencare progetti

Query di esempio

Esempio di risposta

Aggiornare le origini

Query di esempio

Esempio di risposta

Ottenere lo stato del processo di aggiornamento dell'origine

Query di esempio

Esempio di risposta

Aggiornare coppie di domande e risposte

Esempio di risposta

Ottenere lo stato del processo di aggiornamento di coppie di domande e risposte

Query di esempio

Esempio di risposta

Aggiornare i sinonimi

Query di esempio

Esempio di risposta

Aggiornare il feedback sull'apprendimento attivo

Query di esempio

Esempio di risposta

Commenti e suggerimenti

Risorse aggiuntive