Agent SDK (anteprima)

Inoltra i payload dell'attività di Bot Framework/Microsoft Agents SDK a un endpoint dell'agente fornito dall'utente. L'URL dell'endpoint agente viene fornito per ogni chiamata come parametro di input. L'autenticazione viene selezionata durante la creazione della connessione: nessuna autenticazione, una chiave API statica o Microsoft Entra ID OAuth (client_credentials). Quando si seleziona OAuth, il gruppo di destinatari del token di connessione (URL risorsa configurato nella connessione) deve corrispondere al gruppo di destinatari previsto dall'agente di destinazione.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Class	Regions
Copilot Studio	Standard	Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Azure cina - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Standard	Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Standard	Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Microsoft
URL	https://support.microsoft.com

Metadati del connettore
Editore	Microsoft
Sito web	https://www.microsoft.com
Informativa sulla privacy	https://privacy.microsoft.com/
Categories	Produttività

Il connettore Agent SDK inoltra i payload dell'attività di Bot Framework/Microsoft Agents SDK a un endpoint agente fornito dall'utente. L'URL dell'endpoint agente viene fornito per ogni chiamata come parametro di input; I token OAuth vengono coniati dalla piattaforma dalle credenziali dell'applicazione fornite dall'utente Microsoft Entra ID configurate nella connessione e inserite come token di connessione in ogni richiesta in uscita. Il gruppo di destinatari del token di connessione (URL della risorsa configurato nella connessione) deve corrispondere al gruppo di destinatari previsto dall'agente di destinazione.

Prerequisiti

Un agente sdk per agenti Microsoft distribuito/Bot Framework raggiungibile tramite HTTPS.
Un'applicazione Microsoft Entra ID registrata nel tenant che ospita l'agente, configurata con la concessione e l'autorizzazione client_credentials per chiamare l'agente di destinazione.
Destinatari del token previsti dell'agente (in genere l'ID app Microsoft dell'agente, ad esempio api://<appId>).

Ottenere le credenziali

Per autenticare le richieste API, è necessario:

ID tenant dell'applicazione Microsoft Entra ID.
ID client (ID applicazione) dell'applicazione Microsoft Entra ID.
Segreto client per l'applicazione.
URL risorsa corrispondente al gruppo di destinatari previsto dall'agente di destinazione (modello di autenticazione delle competenze di Bot Framework).

Specificare questi valori quando si crea una connessione. Creare una connessione per agente se i gruppi di destinatari sono diversi.

Problemi noti e limitazioni

L'input agentEndpoint deve essere un URL HTTPS completo (ad esempio, https://my-agent.azurewebsites.net). Il connettore aggiunge /api/messages e inoltra il payload dell'attività.
Il connettore inoltra il payload attività as-is e non imposta deliveryMode. L'agente risponde in modo asincrono (recapito normale) tramite POSTing le attività di risposta all'oggetto fornito nell'attività serviceUrl in ingresso (il chiamante, ad esempio Microsoft Copilot Studio, fornisce un callback serviceUrlcon chiave DI firma di accesso condiviso).
Questo connettore è in anteprima. Disponibilità e funzionalità sono soggette a modifiche.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:


Chiave API	Eseguire l'autenticazione con una chiave API statica prevista dall'agente di destinazione in un'intestazione HTTP personalizzata. Specificare sia il nome dell'intestazione ,ad esempio x-api-key, sia il relativo valore.	Tutte le aree geografiche	Non condivisibile
Microsoft Entra ID (credenziali client)	Token di connessione OAuth mint da un'applicazione Microsoft Entra ID usando il flusso di client_credentials. Il gruppo di destinatari del token di connessione (URL risorsa) deve corrispondere al gruppo di destinatari previsto dall'agente di destinazione.	Tutte le aree geografiche	Non condivisibile
Nessuna autenticazione	Chiamare l'endpoint dell'agente di destinazione senza alcuna intestazione di autenticazione. Usare questa opzione solo con gli agenti che accettano in modo esplicito chiamate anonime.	Tutte le aree geografiche	Condivisibile
Impostazione predefinita [DEPRECATO]	Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.	Tutte le aree geografiche	Non condivisibile

API key

ID di autenticazione: apiKey

Applicabile: tutte le aree

Eseguire l'autenticazione con una chiave API statica prevista dall'agente di destinazione in un'intestazione HTTP personalizzata. Specificare sia il nome dell'intestazione ,ad esempio x-api-key, sia il relativo valore.

Questa connessione non è condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	Tipo	Descrzione	Obbligatorio
Nome dell'intestazione della chiave API	string	Nome dell'intestazione HTTP in cui l'agente di destinazione prevede la chiave API (ad esempio, x-api-key o Ocp-Apim-Subscription-Key).	True
Valore della chiave API	Securestring	Valore della chiave API statica inviato a ogni richiesta all'endpoint dell'agente di destinazione.	True

Microsoft Entra ID (credenziali client)

ID autenticazione: oauthClientCredentials

Applicabile: tutte le aree

Token di connessione OAuth mint da un'applicazione Microsoft Entra ID usando il flusso di client_credentials. Il gruppo di destinatari del token di connessione (URL risorsa) deve corrispondere al gruppo di destinatari previsto dall'agente di destinazione.

Questa connessione non è condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	Tipo	Descrzione	Obbligatorio
Tenant	string	ID tenant di per l'applicazione Microsoft Entra ID	True
ID del cliente	string	ID client (o applicazione) dell'applicazione Microsoft Entra ID.	True
Segreto del cliente	Securestring	Segreto client dell'applicazione Microsoft Entra ID.	True
URL della risorsa	string	Destinatari per il token OAuth. In genere, l'ID app Microsoft dell'agente di destinazione, ad esempio api://< appId> o il GUID ID app.	True

Nessuna autenticazione

ID autenticazione: anonimo

Applicabile: tutte le aree

Chiamare l'endpoint dell'agente di destinazione senza alcuna intestazione di autenticazione. Usare questa opzione solo con gli agenti che accettano in modo esplicito chiamate anonime.

Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa connessione non è condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Azioni

Inviare attività all'agente

Inoltra un payload del protocollo attività all'endpoint dell'agente in {agentEndpoint}/api/messages. Quando la connessione usa Microsoft Entra ID OAuth, il gruppo di destinatari del token (URL risorsa nella connessione) deve essere uguale al gruppo di destinatari previsto dall'agente di destinazione (modello di autenticazione della competenza di Bot Framework); creare una connessione per ogni agente se i destinatari differiscono. Il connettore inoltra il payload attività as-is e non imposta 'deliveryMode'; l'agente risponde in modo asincrono (recapito normale) tramite POSTing attività di risposta all'oggetto 'serviceUrl' fornito nell'attività in ingresso.

Inviare attività all'agente

ID operazione:: SendActivity

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
URL endpoint agente	agentEndpoint	True	string	URL di base del Microsoft Agents SDK /Bot Framework endpoint (ad esempio, https://my-agent.azurewebsites.net). Il connettore aggiunge /api/messages.
			object

Agent SDK (anteprima)

Prerequisiti

Ottenere le credenziali

Problemi noti e limitazioni

Creazione di una connessione

API key

Microsoft Entra ID (credenziali client)

Nessuna autenticazione

Impostazione predefinita [DEPRECATO]

Azioni

Inviare attività all'agente

Parametri

Valori restituiti

Definizioni

object