Come creare progetti nel flusso di lavoro di orchestrazione

Il flusso di lavoro di orchestrazione consente di creare progetti che connettono le applicazioni a:

• Custom Language Understanding
• Risposta alle domande
• LUIS

Prerequisiti

Prima di iniziare a usare il flusso di lavoro di orchestrazione, sono necessari diversi aspetti:

• Una sottoscrizione di Azure: crearne una gratuitamente.
• Una risorsa del linguaggio di intelligenza artificiale di Azure

Creare una risorsa del servizio Lingua

Prima di iniziare a usare il flusso di lavoro di orchestrazione, è necessaria una risorsa del linguaggio di intelligenza artificiale di Azure.

Nota

• Per creare una risorsa lingua, è necessario avere un ruolo di proprietario assegnato nel gruppo di risorse.
• Se si prevede di usare la risposta alle domande, è necessario abilitare la risposta alle domande nella creazione di risorse

Creare una nuova risorsa dal portale di Azure

1. Passare alla portale di Azure per creare una nuova risorsa del linguaggio di intelligenza artificiale di Azure.

2. Selezionare Continua per creare la risorsa

3. Creare una risorsa lingua con i dettagli seguenti.

   Dettagli dell'istanza	Valore obbligatorio
   Area	Una delle aree supportate.
   Nome	Nome della risorsa lingua.
   Piano tariffario	Uno dei piani tariffari supportati.

Creare una nuova risorsa lingua da Language Studio

Se è la prima volta che si accede, verrà visualizzata una finestra in Language Studio che consentirà di scegliere una risorsa lingua esistente o crearne una nuova. È anche possibile creare una risorsa facendo clic sull'icona delle impostazioni nell'angolo in alto a destra, selezionando Risorse e quindi facendo clic su Crea una nuova risorsa.

Creare una risorsa lingua con i dettagli seguenti.

Dettagli dell'istanza	Valore obbligatorio
Sottoscrizione di Azure	la propria sottoscrizione di Azure
Gruppo di risorse di Azure	Gruppo di risorse di Azure
Nome risorsa di Azure	Nome della risorsa di Azure
Titolo	Altre informazioni sulle aree supportate.
Piano tariffario	Altre informazioni sui piani tariffari supportati.

Importante

• Assicurarsi di abilitare l'identità gestita quando si crea una risorsa lingua.
• Leggere e confermare l'avviso di IA responsabile

Accedere a Language Studio

Per creare una nuova finalità, selezionare +Aggiungi pulsante e iniziare assegnando un nome alla finalità. Verranno visualizzate due opzioni, per connettersi a un progetto o meno. È possibile connettersi a progetti LUIS, question answering o Conversational Language Understanding oppure scegliere l'opzione no .

Creare un progetto flusso di lavoro di orchestrazione

Dopo aver creato una risorsa language, creare un progetto flusso di lavoro di orchestrazione.

Language Studio

1. In Language Studio trovare la sezione Informazioni sulle domande e sul linguaggio di conversazione e selezionare Flusso di lavoro di orchestrazione.

   

2. Verrà visualizzata la pagina del progetto flusso di lavoro orchestrazione. Selezionare Crea nuovo progetto. Per creare un progetto, è necessario specificare i dettagli seguenti:

Valore	Descrizione
Name	Nome del progetto.
Descrizione	Descrizione facoltativa del progetto.
Linguaggio primario delle espressioni	Lingua principale del progetto. I dati di training devono trovarsi principalmente in questa lingua.

Al termine, selezionare Avanti ed esaminare i dettagli. Selezionare Crea progetto per completare il processo. Verrà visualizzata la schermata Schema di compilazione nel progetto.

API REST

Inviare una richiesta PATCH usando l'URL, le intestazioni e il corpo JSON seguenti per creare un nuovo progetto.

Richiesta URL

Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{API-VERSION}	Versione dell'API che si sta chiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	Valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Body

Usare il codice JSON di esempio seguente come corpo.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

Key	Segnaposto	Valore	Esempio
projectName	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	EmailApp
language	{LANGUAGE-CODE}	Stringa che specifica il codice del linguaggio per le espressioni usate nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguistico della maggior parte delle espressioni.	en-us

Importare un progetto flusso di lavoro di orchestrazione

Language Studio

È possibile esportare un progetto flusso di lavoro di orchestrazione come file JSON in qualsiasi momento passando alla pagina dei progetti del flusso di lavoro di orchestrazione, selezionando un progetto e dal menu in alto, facendo clic su Esporta.

Tale progetto può essere reimportato come nuovo progetto. Se si importa un progetto con lo stesso nome, i dati del progetto vengono sostituiti con i dati del progetto appena importati.

Per importare un progetto, selezionare il pulsante freccia accanto a Crea un nuovo progetto e selezionare Importa e quindi selezionare il file JSON.

API REST

È possibile importare un file JSON del flusso di lavoro di orchestrazione nel servizio

Inviare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per importare il progetto.

Richiesta URL

Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{API-VERSION}	Versione dell'API che si sta chiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	Valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Body

Nota

Ogni finalità deve essere di un solo tipo da (CLU, LUIS e qna)

Usare il codice JSON di esempio seguente come corpo.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Orchestration",
    "settings": {
      "confidenceThreshold": 0
    },
    "projectName": "{PROJECT-NAME}",
    "description": "Project description",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Orchestration",
    "intents": [
      {
        "category": "string",
        "orchestration": {
          "kind": "luis",
          "luisOrchestration": {
            "appId": "00000000-0000-0000-0000-000000000000",
            "appVersion": "string",
            "slotName": "string"
          },
          "cluOrchestration": {
            "projectName": "string",
            "deploymentName": "string"
          },
          "qnaOrchestration": {
            "projectName": "string"
          }
        }
      }
    ],
    "utterances": [
      {
        "text": "Trying orchestration",
        "language": "{LANGUAGE-CODE}",
        "intent": "string"
      }
    ]
  }
}

Key	Segnaposto	Valore	Esempio
api-version	{API-VERSION}	Versione dell'API che si sta chiamando. La versione usata qui deve essere la stessa versione dell'API nell'URL.	2022-03-01-preview
projectName	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	EmailApp
language	{LANGUAGE-CODE}	Stringa che specifica il codice del linguaggio per le espressioni usate nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguistico della maggior parte delle espressioni.	en-us

Esporta progetto

Language Studio

È possibile esportare un progetto del flusso di lavoro di orchestrazione come file JSON in qualsiasi momento passando alla pagina dei progetti del flusso di lavoro di orchestrazione, selezionando un progetto e premendo Esporta.

API REST

È possibile esportare un progetto del flusso di lavoro di orchestrazione come file JSON in qualsiasi momento.

Creare una richiesta POST usando l'URL, le intestazioni e il corpo JSON seguenti per esportare il progetto.

Richiesta URL

Usare l'URL seguente durante la creazione della richiesta API. Sostituire i valori segnaposto seguenti con i propri valori.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	EmailApp
{API-VERSION}	Versione dell'API che si sta chiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	Valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica l'esito positivo. Nelle intestazioni della risposta estrarre il operation-location valore. Il formato sarà simile al seguente:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID viene usato per identificare la richiesta, poiché questa operazione è asincrona. Usare questo URL per ottenere il codice JSON del progetto esportato usando lo stesso metodo di autenticazione.

Ottenere i dettagli del progetto di orchestrazione

Language Studio

1. Passare alla pagina delle impostazioni del progetto in Language Studio.

2. È possibile visualizzare i dettagli del progetto.

3. In questa pagina è possibile aggiornare la descrizione del progetto.

4. È anche possibile recuperare la chiave primaria della risorsa da questa pagina.

   

API REST

Per ottenere i dettagli di un progetto del flusso di lavoro di orchestrazione, inviare una richiesta GET usando l'URL e le intestazioni seguenti. Sostituire i valori segnaposto con i propri valori.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{API-VERSION}	Versione dell'API che si sta chiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	Valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Testo della risposta

Dopo aver inviato la richiesta, si otterrà la risposta seguente.

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration project.",
  "language": "{LANGUAGE-CODE}"
}

Dopo aver inviato la richiesta API, si riceverà una 200 risposta che indica l'esito positivo e il corpo della risposta JSON con i dettagli del progetto.

Eliminare un progetto

Language Studio

Quando il progetto non è più necessario, è possibile eliminare il progetto usando Language Studio. Selezionare Progetti dal menu di spostamento a sinistra, selezionare il progetto da eliminare e quindi selezionare Elimina dal menu in alto.

API REST

Quando non è più necessario il progetto, è possibile eliminare il progetto usando le API.

Creare una richiesta DELETE usando l'URL, le intestazioni e il corpo JSON seguenti per eliminare un progetto di comprensione del linguaggio di conversazione.

Richiesta URL

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Segnaposto	Valore	Esempio
{ENDPOINT}	Endpoint per l'autenticazione della richiesta API.	https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	myProject
{API-VERSION}	Versione dell'API che si sta chiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	Valore
Ocp-Apim-Subscription-Key	Chiave della risorsa. Usato per l'autenticazione delle richieste API.

Dopo aver inviato la richiesta API, si riceverà una 202 risposta che indica l'esito positivo, il che significa che il progetto è stato eliminato.

Passaggi successivi

Schema di compilazione