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 è 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 In V2, l'espressione da stimare è nel parametro q.

In V3, la funzionalità viene passata nel parametro query.
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, queste sono state restituite in una matrice.
verbose Includi più dettagli delle entità boolean V2 & V3 false Nella versione 2, se impostate su true, vengono restituite tutte le finalità stimate. Se sono necessarie tutte le finalità stimate, usare il parametro V3 di show-all-intents.

In V3, 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. Sostituisce timezoneOffset dalla versione 2.

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