Condividi tramite

Concetti chiave nell'API bot Connector

Bot Framework e Azure AI servizio Bot consentono al bot di comunicare con gli utenti in Teams, Facebook e altro ancora. I canali sono disponibili in due forme:

  • Come servizio incluso nell'ambito del servizio Bot di intelligenza artificiale di Azure.
  • Come librerie di adattatori da usare con Bot Framework SDK.

Questo articolo è incentrato sui canali standard inclusi nell'servizio Bot di intelligenza artificiale di Azure.

Canali di Bot Framework

I canali bot Framework consentono al bot di scambiare messaggi con i canali configurati nella portale di Azure. Usa i protocolli JSON e REST standard del settore al posto di HTTPS e abilita l'autenticazione con il token di connessione JWT. Per informazioni dettagliate su come usare il servizio Bot Connector, vedere Autenticazione e gli articoli rimanenti in questa sezione.

Impegno

Il servizio Connector scambia informazioni tra bot e canale (utente) passando un oggetto Activity . Il tipo più comune di attività è message, ma esistono altri tipi di attività che possono essere usati per comunicare i vari tipi di informazione da un canale o un bot. Per informazioni dettagliate sulle attività nel servizio Bot Connector, vedere la panoramica delle attività.

Autenticazione

Il servizio Bot Framework usa token di connessione JWT per l'autenticazione. Per informazioni dettagliate su come autenticare le richieste in uscita inviate dal bot a Bot Framework e su come autenticare le richieste in ingresso ricevute dal bot da Bot Framework, vedere Autenticazione.

Librerie client

Bot Framework fornisce librerie client che possono essere usate per compilare bot in C#, JavaScript, Python e Java.

Nota

Per creare agenti con la scelta di servizi di intelligenza artificiale, orchestrazione e conoscenze, è consigliabile usare Microsoft 365 Agents SDK. Agents SDK supporta C#, JavaScript o Python. Per altre informazioni su Agents SDK , vedere aka.ms/agents. Se si sta cercando una piattaforma agente basata su SaaS, prendere in considerazione Microsoft Copilot Studio. Se si dispone di un bot esistente compilato con Bot Framework SDK, è possibile aggiornare il bot ad Agents SDK. È possibile esaminare le modifiche e gli aggiornamenti principali in Bot Framework SDK per le linee guida per la migrazione di Agents SDK. I ticket di supporto per Bot Framework SDK non verranno più gestiti a partire dal 31 dicembre 2025.

Oltre a semplificare le chiamate alle API REST di Bot Framework, ogni Bot Framework SDK offre anche il supporto per la creazione di dialoghi che incapsulano la logica di conversazione, richieste predefinite per semplici operazioni come Sì/No, stringhe, numeri ed enumerazioni, il supporto predefinito per framework di intelligenza artificiale potenti come LUIS e altro ancora.

Nota

Azure AI QnA Maker verrà ritirato il 31 marzo 2025. A partire dal 1° ottobre 2022, non potrai creare nuove risorse o Knowledge Base di QnA Maker. Una versione più recente della funzionalità di domande e risposte è ora disponibile come parte di Lingua di Azure AI.

La risposta alle domande personalizzate, una funzionalità del linguaggio di intelligenza artificiale di Azure, è la versione aggiornata del servizio QnA Maker. Per altre informazioni sul supporto di domande e risposte in Bot Framework SDK, vedere Comprensione del linguaggio naturale.

Nota

Language Understanding (LUIS) verrà ritirato il 1° ottobre 2025. A partire dal 1° aprile 2023, non sarà possibile creare nuove risorse LUIS. Una versione più recente di Language Understanding è ora disponibile come parte del linguaggio di intelligenza artificiale di Azure.

CLU (Conversational Language Understanding), una funzionalità del linguaggio di intelligenza artificiale di Azure, è la versione aggiornata di LUIS. Per altre informazioni sul supporto per la comprensione del linguaggio in Bot Framework SDK, vedere Comprensione del linguaggio naturale.

Nota

In alternativa all'uso di questi SDK, è possibile generare una libreria client personalizzata nel linguaggio preferito usando il file Swagger di Bot Connector o il codice diretto all'API REST.

Servizio Bot State

Il servizio di informazioni sullo stato di Microsoft Bot Framework è stato ritirato il 30 marzo 2018. In precedenza, i bot basati su Azure AI servizio Bot o Bot Builder SDK avevano una connessione predefinita a questo servizio ospitato da Microsoft per archiviare i dati sullo stato del bot. I bot dovranno essere aggiornati per usare il proprio spazio di archiviazione dello stato.

Informazioni aggiuntive

Per altre informazioni sulla creazione di bot con il servizio Connector, vedere gli articoli in questa sezione, a partire dall'autenticazione. Se si verificano problemi o si hanno suggerimenti relativi al servizio Connettore, vedere Supporto per un elenco delle risorse disponibili.