Come creare un progetto CLU

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

Prerequisiti

Prima di iniziare a usare la CLU, sono necessarie diverse cose:

• Una sottoscrizione di Azure: creare un account gratuitamente.
• Una risorsa di Lingua di Azure AI

Creare una risorsa del servizio Lingua

Prima di iniziare a usare la CLU, è necessaria una risorsa Lingua di Azure AI.

Nota

• Per creare una risorsa Linguaggio, è 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 di Lingua di Azure AI.

2. Selezionare Crea una nuova risorsa

3. Nella finestra visualizzata cercare Servizio di linguaggio

4. Selezionare Crea.

5. Creare una risorsa linguistica con i dettagli seguenti.

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

Creare una nuova risorsa Linguaggio da Studio di linguaggio

Al primo accesso verrà visualizzata una finestra in Language Studio che consente di scegliere una risorsa linguistica esistente o crearne una nuova. È possibile creare una risorsa anche facendo clic sull'icona delle impostazioni nell'angolo superiore destro, selezionando Risorse e facendo clic su Crea una nuova risorsa.

Creare una risorsa linguistica 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 Linguaggio
Ufficio	Una delle regioni supportate per la risorsa Linguaggio.
Piano tariffario	Uno dei piani tariffari supportati per la risorsa Linguaggio.

Importante

• Abilitare Identità gestita durante la creazione di una risorsa linguistica.
• Leggere e confermare l'avviso di Intelligenza artificiale responsabile

Accedere a Studio di linguaggio

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

2. Nella finestra Selezionare una risorsa Lingua visualizzata individuare la sottoscrizione di Azure e selezionare la risorsa Linguaggio. 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 di gruppo di risorse di Azure.
   Nome risorsa di Azure	Nome della risorsa di Azure.
   Ufficio	Una delle regioni supportate per la risorsa Linguaggio. Ad esempio: "Stati Uniti occidentali 2".
   Piano tariffario	Uno dei piani tariffarivalidi per la risorsa Linguaggio. Per provare il servizio, è possibile usare il piano tariffario gratuito (F0).

   

Creare un progetto di conversazione

Dopo aver creato una risorsa Linguaggio, creare un progetto Comprensione del linguaggio di conversazione.

Studio di linguaggio

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

2. Verrà visualizzata la pagina dei Progetti di comprensione del linguaggio di conversazione. Selezionare Crea nuovo progetto.

   

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

Valore	Descrizione
Name	Un nome del progetto. Una volta creato, non è possibile modificarlo
Descrizione	Descrizione facoltativa del progetto.
Lingua principale delle espressioni	Lingua principale del progetto. I dati di training devono trovarsi principalmente in questo linguaggio.
Abilitare più lingue	Se si desidera abilitare il progetto per supportare diversi linguaggi contemporaneamente.

Al termine, selezionare Avanti ed esaminare i dettagli. Fare clic su Crea per completare la procedura. 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}	La versione dell'API che si sta richiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave della risorsa. È usata per l’autenticazione delle richieste API.
Content-Type	'application/merge-patch+json'

Corpo

Usare il codice JSON di esempio seguente come corpo.

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

Chiave	Segnaposto	Valore	Esempio
projectName	{PROJECT-NAME}	Il nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	EmailApp
language	{LANGUAGE-CODE}	Una stringa che specifica il codice lingua per le espressioni usate nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguaggio della maggior parte delle espressioni.	en-us
multilingual	true	Valore booleano che consente di avere documenti in diversi linguaggi 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 delle lingue.	true

Importare il progetto

Studio di linguaggio

È possibile esportare un progetto Comprensione del linguaggio di conversazione come file JSON in qualsiasi momento andando alla pagina dei progetti di conversazione, selezionando un progetto e facendo clic su Esporta nel menu in alto.

È possibile importare nuovamente tale progetto come nuovo progetto. Se si importa un progetto con lo stesso nome, i dati del progetto vengono sostituiti con quelli del progetto appena importato.

Se si dispone di un'applicazione LUIS esistente, è possibile importare direttamente l'applicazione LUIS in Comprensione del linguaggio di conversazione; 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 Comprensione del linguaggio di conversazione.

API REST

È possibile importare un file CLU JSON 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 per 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 importato.	EmailAppDemo
{API-VERSION}	La versione dell'API che viene richiamata.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave della risorsa. È usata per l’autenticazione delle richieste API.

Corpo

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": []
      }
    ]
  }
}

Chiave	Segnaposto	Valore	Esempio
{API-VERSION}	La versione dell'API che viene richiamata.	2023-04-01
projectName	{PROJECT-NAME}	Il nome del progetto. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.	EmailAppDemo
language	{LANGUAGE-CODE}	Una stringa che specifica il codice lingua per le espressioni usate nel progetto. Se il progetto è un progetto multilingue, scegliere il codice linguaggio della maggior parte delle espressioni.	en-us
multilingual	true	Valore booleano che consente di avere documenti in diversi linguaggi nel set di dati. Quando il modello viene distribuito, è possibile eseguire query sul modello in qualsiasi linguaggio supportato, compresi quelli non inclusi 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 uno 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. È formattata 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 Comprensione del linguaggio di conversazione come file JSON in qualsiasi momento andando alla pagina dei progetti di conversazione, selezionando un progetto e premendo Esporta.

API REST

È possibile esportare un progetto Comprensione del linguaggio di conversazione 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}	La versione dell'API che si sta richiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave della risorsa. È usata per l’autenticazione delle richieste API.

Dopo aver inviato la richiesta API, si riceverà una risposta 202 che indica l'esito positivo. Nelle intestazioni della risposta, estrarre il valore operation-location. 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

Studio di linguaggio

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. In questa pagina è anche possibile recuperare la chiave primaria della risorsa.

   

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}	La versione dell'API che si sta richiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave della risorsa. È usata 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 risposta 200 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 eliminarlo usando Language Studio. Selezionare Progetti nel menu di spostamento a sinistra, selezionare il progetto da eliminare, quindi selezionare Elimina nel menu in alto.

API REST

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

Creare una richiesta ELIMINA 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}	La versione dell'API che si sta richiamando.	2023-04-01

Intestazioni

Usare l'intestazione seguente per autenticare la richiesta.

Chiave	valore
Ocp-Apim-Subscription-Key	La chiave della risorsa. È usata per l’autenticazione delle richieste API.

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

Passaggi successivi

Schema di compilazione