Risorse per sviluppatori sdk, REST e dell'interfaccia della riga di comando per Language Understanding (LUIS)

  • Articolo

Importante

LUIS verrà ritirato il 1 ottobre 2025 e a partire dal 1 aprile 2023 non sarà più possibile creare nuove risorse LUIS. Si consiglia di eseguire la migrazione delle applicazioni LUIS a comprensione del linguaggio di conversazione per sfruttare appieno un supporto costante per i prodotti e le funzionalità multilingue.

SDK, API REST, interfaccia della riga di comando, consentono di sviluppare app Luis (Language Understanding) nel linguaggio di programmazione. Gestire le risorse di Azure e le stime LUIS.

Gestione delle risorse di Azure

Usare il livello di gestione dei servizi di intelligenza artificiale di Azure per creare, modificare, elencare ed eliminare la risorsa Language Understanding o i servizi di intelligenza artificiale di Azure.

Trovare la documentazione di riferimento in base allo strumento:

Richieste di creazione e stima di Language Understanding

È possibile accedere al servizio Language Understanding da una risorsa di Azure da creare. Esistono due risorse:

  • Usare la risorsa di creazione per il training per creare, modificare, eseguire il training e pubblicare.
  • Usare la stima per il runtime per inviare il testo dell'utente e ricevere una stima.

Usare il codice di esempio dei servizi di intelligenza artificiale di Azure per apprendere e usare le attività più comuni.

Specifiche REST

Le specifiche REST luis, insieme a tutte le specifiche REST di Azure, sono disponibili pubblicamente in GitHub.

API REST

Sia la creazione che l'API dell'endpoint di stima sono disponibili dalle API REST:

Type Versione
Creazione V2
anteprima V3
Previsione V2
V3

Endpoint REST

LUIS dispone attualmente di 2 tipi di endpoint:

  • creazione nell'endpoint di training
  • eseguire query sulla stima sull'endpoint di runtime.
Scopo URL
Creazione V2 nell'endpoint di training https://{your-resource-name}.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appID}/
Creazione V3 nell'endpoint di training https://{your-resource-name}.api.cognitive.microsoft.com/luis/authoring/v3.0-preview/apps/{appID}/
Stima V2: tutte le stime nell'endpoint di runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?q={q}[&timezoneOffset][&verbose][&spellCheck][&staging][&bing-spell-check-subscription-key][&log]
Stima V3 - Stima delle versioni nell'endpoint di runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?query={query}[&verbose][&log][&show-all-intents]
Stima V3 - Stima dello slot nell'endpoint di runtime https://{your-resource-name}.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?query={query}[&verbose][&log][&show-all-intents]

La tabella seguente illustra i parametri indicati con parentesi graffe {} nella tabella precedente.

Parametro Scopo
your-resource-name Nome risorsa di Azure
q oppure query testo dell'espressione inviato dall'applicazione client, ad esempio chatbot
version Nome della versione di 10 caratteri
slot production oppure staging

Parametri della stringa di query REST

I parametri della stringa di query dell'API V3 includono:

Query parameter (Parametro di query) Nome del portale LUIS Type Versione Default Scopo
log Salva log boolean V2 & V3 false Archiviare la query nel file di log. Il valore predefinito è false.
query - string Solo V3 Nessun valore predefinito: è necessario nella richiesta GET Nella versione 2 l'espressione da stimare è nel q parametro .

Nella versione 3 la funzionalità viene passata nel query parametro .
show-all-intents Includi i punteggi per tutte le finalità boolean Solo V3 false Restituisce tutte le finalità con il punteggio corrispondente nell'oggetto prediction.intents . Le finalità vengono restituite come oggetti in un oggetto padre intents . In questo modo è possibile accedere a livello di codice senza dover trovare la finalità in una matrice: prediction.intents.give. Nella versione 2, questi sono stati restituiti in una matrice.
verbose Includi più dettagli delle entità boolean V2 & V3 false Nella versione 2, se impostata su true, vengono restituite tutte le finalità stimate. Se sono necessarie tutte le finalità stimate, usare il parametro V3 di show-all-intents.

Nella versione 3 questo parametro fornisce solo i dettagli dei metadati dell'entità per la stima dell'entità.
timezoneOffset - string V2 - Fuso orario applicato alle entità datetimeV2.
datetimeReference - string V3 - Fuso orario applicato alle entità datetimeV2. timezoneOffset Sostituisce da V2.

Schema dell'app

Lo schema dell'app viene importato ed esportato in un .json formato o .lu .

SDK basati sul linguaggio

Lingua Documentazione di riferimento Pacchetto Avvi rapidi
C# Creazione di
stime		 Creazione di NuGet
Stima NuGet		 Creazione
Stima delle query
Go Creazione e stima SDK
Java Creazione e stima Creazione di Maven
Stima Maven
JavaScript Creazione
Previsione		 Creazione di NPM
Stima NPM		 Creazione
Previsione
Python Creazione e stima Pip Creazione
Previsione

Contenitori

Language Understanding (LUIS) fornisce un contenitore per fornire versioni locali e contenute dell'app.

Esportare e importare formati

Language Understanding offre la possibilità di gestire l'app e i relativi modelli in formato JSON, il .LU formato (LUDown) e un pacchetto compresso per il contenitore Language Understanding.

L'importazione e l'esportazione di questi formati sono disponibili dalle API e dal portale LUIS. Il portale fornisce l'importazione e l'esportazione come parte dell'elenco Delle app e delle versioni.

Workshop

Strumenti di integrazione continua

Strumenti di Bot Framework

Bot Framework è disponibile come SDK in un'ampia gamma di linguaggi e come servizio usando Azure AI servizio Bot.

Bot Framework offre diversi strumenti utili per Language Understanding, tra cui:

  • Bot Framework Emulator : un'applicazione desktop che consente agli sviluppatori di bot di testare ed eseguire il debug dei bot creati con Bot Framework SDK
  • Bot Framework Composer : uno strumento di sviluppo integrato per sviluppatori e team multidisciplinari per creare bot ed esperienze di conversazione con Microsoft Bot Framework
  • Esempi di Bot Framework: in #C, JavaScript, TypeScript e Python

Passaggi successivi