Come creare un progetto CLU

Usare questo articolo per informazioni su come configurare questi requisiti e creare un progetto.

Prerequisiti

Prima di iniziare a usare CLU, 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 CLU, è 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.

Creare una nuova risorsa dal portale di Azure

1. Accedere al portale di Azure per creare una nuova risorsa del linguaggio di intelligenza artificiale di Azure.

2. Selezionare Crea una nuova risorsa

3. Nella finestra visualizzata cercare Servizio lingua

4. Selezionare Crea.

5. Creare una risorsa lingua con i dettagli seguenti.

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

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 lingua
Titolo	Aree supportate per la risorsa Lingua.
Piano tariffario	Piani tariffari supportati per la risorsa Lingua.

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

1. Passare a Language Studio e accedere con l'account Azure.

2. Nella finestra Scegliere una risorsa della lingua visualizzata individuare la sottoscrizione di Azure e scegliere la risorsa Lingua. Se non si ha una risorsa, è possibile crearne una nuova.

   Dettagli dell'istanza	Valore obbligatorio
   Sottoscrizione di Azure	La sottoscrizione di Azure.
   Gruppo di risorse di Azure	Nome del gruppo di risorse di Azure.
   Nome risorsa di Azure	Nome della risorsa di Azure.
   Titolo	Una delle aree supportate per la risorsa Lingua. Ad esempio, "Stati Uniti occidentali 2".
   Piano tariffario	Uno dei piani tariffari validi per la risorsa Lingua. È possibile usare il livello Gratuito (F0) per provare il servizio.

   

Creare un progetto di conversazione

Dopo aver creato una risorsa language, creare un progetto Conversational Language Understanding.

Language Studio

1. In Language Studio individuare la sezione denominata Comprendere le domande e il linguaggio di conversazione e selezionare Comprensione del linguaggio conversazionale.
   

2. Verrà visualizzata la pagina Dei progetti di comprensione del linguaggio conversazionale. Selezionare Crea nuovo progetto.

   

Per creare un nuovo progetto, è necessario specificare i dettagli seguenti:

Valore	Descrizione
Name	Nome del progetto. Una volta creato, non può essere modificato
Descrizione	Descrizione facoltativa del progetto.
Linguaggio primario delle espressioni	Lingua principale del progetto. I dati di training devono trovarsi principalmente in questa lingua.
Abilitare più lingue	Se si vuole abilitare il progetto per supportare più lingue contemporaneamente.

Al termine, selezionare Avanti ed esaminare i dettagli. Selezionare Crea 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.
Content-Type	'application/merge-patch+json'

Body

Usare il codice JSON di esempio seguente come corpo.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Conversation",
  "description": "Project description",
  "multilingual": true
}

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
multilingual	true	Valore booleano che consente di avere documenti in più lingue nel set di dati e quando il modello viene distribuito, è possibile eseguire query sul modello in qualsiasi linguaggio supportato (non necessariamente incluso nei documenti di training). Per altre informazioni sul supporto multilingue, vedere Supporto linguistico.	true

Importare il progetto

Language Studio

È possibile esportare un progetto Conversational Language Understanding come file JSON in qualsiasi momento passando alla pagina dei progetti di conversazione, 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.

Se si dispone di un'applicazione LUIS esistente, è possibile importare direttamente l'applicazione LUIS in Conversational Language Understanding e verrà creato un progetto di conversazione con tutte le parti attualmente disponibili: finalità, entità ML ed espressioni. Per altre informazioni, vedere l'articolo sulla migrazione di LUIS.

Per importare un progetto, selezionare il pulsante freccia accanto a Crea un nuovo progetto e selezionare Importa, quindi selezionare il file JSON LUIS o Conversational Language Understanding.

API REST

È possibile importare un file JSON CLU 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 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. Questo valore fa distinzione tra maiuscole e minuscole e deve corrispondere al nome del progetto nel file JSON che si sta importando.	EmailAppDemo
{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

Il corpo JSON inviato è simile all'esempio seguente. Per altri dettagli sull'oggetto JSON, vedere la documentazione di riferimento.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Conversation",
    "settings": {
      "confidenceThreshold": 0.7
    },
    "projectName": "{PROJECT-NAME}",
    "multilingual": true,
    "description": "Trying out CLU",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Conversation",
    "intents": [
      {
        "category": "intent1"
      },
      {
        "category": "intent2"
      }
    ],
    "entities": [
      {
        "category": "entity1"
      }
    ],
    "utterances": [
      {
        "text": "text1",
        "dataset": "{DATASET}",
        "intent": "intent1",
        "entities": [
          {
            "category": "entity1",
            "offset": 5,
            "length": 5
          }
        ]
      },
      {
        "text": "text2",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "intent": "intent2",
        "entities": []
      }
    ]
  }
}

Key	Segnaposto	Valore	Esempio
{API-VERSION}	Versione dell'API che si sta chiamando.	2023-04-01
projectName	{PROJECT-NAME}	Nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	EmailAppDemo
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
multilingual	true	Valore booleano che consente di avere documenti in più lingue nel set di dati. Quando il modello viene distribuito, è possibile eseguire query sul modello in qualsiasi linguaggio supportato, incluse le lingue non incluse nei documenti di training.	true
dataset	{DATASET}	Vedere come eseguire il training di un modello per informazioni sulla suddivisione dei dati tra un set di test e un set di training. I valori possibili per questo campo sono Train e Test.	Train

Quando una richiesta ha esito positivo, la risposta api conterrà un'intestazione operation-location con un URL che è possibile usare per controllare lo stato del processo di importazione. È formattato come segue:

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

Esporta progetto

Language Studio

È possibile esportare un progetto Conversational Language Understanding come file JSON in qualsiasi momento passando alla pagina dei progetti di conversazione, selezionando un progetto e premendo Esporta.

API REST

È possibile esportare un progetto Conversational Language Understanding 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 CLU

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 e abilitare/disabilitare il set di dati multilingue nelle impostazioni del progetto.

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

   

API REST

Per ottenere i dettagli del progetto, 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": "Conversation",
  "projectName": "{PROJECT-NAME}",
  "multilingual": true,
  "description": "This is a sample conversation 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