Agent SDK (Preview)

Předává datové části aktivity sady SDK pro agenty služby Bot Framework / Microsoft do koncového bodu agenta zadaného uživatelem. Adresa URL koncového bodu agenta se zadává na volání jako vstupní parametr. Při vytváření připojení se vybere ověřování: bez ověřování, statického klíče rozhraní API nebo Microsoft Entra ID OAuth (client_credentials nebo přihlášení uživatele). Při výběru OAuth musí cílová skupina nosných tokenů (adresa URL prostředku nakonfigurovaná na připojení) odpovídat cílové skupině očekávané cílovým agentem.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Standard	Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Logické aplikace	Standard	Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Azure oblasti Čína - Ministerstvo obrany USA (DoD)
Power Apps	Standard	Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Automatizace napájení	Standard	Všechny oblasti Power Automate kromě následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)

Kontakt
Název	Microsoft
URL	https://support.microsoft.com

Metadata konektoru
Vydavatel	Microsoft
Internetová stránka	https://www.microsoft.com
Zásady ochrany osobních údajů	https://privacy.microsoft.com/
Kategorie	Produktivita

Konektor sady Sdk agenta předává datové části aktivity sady Sdk agentů služby Bot Framework / Microsoft do koncového bodu agenta zadaného uživatelem. Adresa URL koncového bodu agenta se zadává na volání jako vstupní parametr. Připojení vybere způsob ověřování konektoru pro agenta: bez ověřování, statického klíče rozhraní API, tokenu jen pro Microsoft Entra ID aplikace (přihlašovací údaje klienta) nebo Microsoft Entra ID delegovaného tokenu uživatele (přihlášení uživatele). U obou Microsoft Entra ID možností musí cílová skupina nosných tokenů (adresa URL prostředku nakonfigurovaná na připojení) odpovídat cílové skupině očekávané cílovým agentem.

Předpoklady

Nasazená sada SDK Microsoft Agents / Agent Bot Framework dostupný přes PROTOKOL HTTPS.
Pro Microsoft Entra ID (přihlašovací údaje klienta):: aplikace Microsoft Entra ID zaregistrovaná v tenantovi, který je hostitelem agenta, nakonfigurovaná s udělením oprávnění a oprávněním client_credentials volat cílového agenta.
Pro Microsoft Entra ID (přihlášení uživatele): vlastní Microsoft Entra ID aplikace agenta (id aplikace Microsoft) s tajným kódem klienta, vystaveným oborem rozhraní API, se kterým můžou uživatelé souhlasit, Microsoft Graph User.Read ("Přihlášení a čtení profilu uživatele") delegované oprávnění se souhlasem a https://global.consent.azure-apim.net/redirect/agentsdk přidáno jako identifikátor URI přesměrování webu.
U možností klíče rozhraní API a přihlašovacích údajů klienta je očekávaná cílová skupina tokenů agenta (obvykle ID aplikace Microsoft agenta, například api://<appId> IDENTIFIKÁTOR GUID ID aplikace). Pro přihlášení uživatele musí být cílovou skupinou GUID ID aplikace (viz níže).

Získání přihlašovacích údajů

Microsoft Entra ID (přihlašovací údaje klienta)

Konektor odešle token jen pro aplikaci. K ověření požadavků rozhraní API budete potřebovat:

ID tenanta aplikace Microsoft Entra ID.
ID klienta (ID aplikace) Microsoft Entra ID aplikace.
Tajný klíč klienta pro danou aplikaci.
Adresa URL prostředku odpovídající cílové skupině očekávané cílovým agentem (vzor ověřování dovedností služby Bot Framework).

Tyto hodnoty zadejte při vytváření připojení. Pokud se cílové skupiny liší, vytvořte pro každého agenta jedno připojení.

Konektor odešle delegovaný token účtu přihlášeného k připojení, aby ho agent mohl vyměnit jménem tohoto účtu (například pomocí obslužné rutiny Sada SDK pro agenty Microsoft 365ConnectorUserAuthorization). Budete potřebovat:

ID tenanta aplikace Microsoft Entra ID agenta.
ID klienta: vlastní Microsoft ID aplikace agenta. Sada SDK pro agenty Microsoft 365 token vymění jménem uživatele pouze v případech, kdy byl token vydán vlastní aplikaci agenta.
Tajný klíč klienta pro danou aplikaci.
Adresa URL prostředku: ID Microsoft aplikace (GUID) agenta, stejnou hodnotu jako ID klienta. Vzhledem k tomu, že vlastní aplikace agenta je klient i prostředek, Microsoft Entra pro tuto možnost vyžaduje identifikátor GUID (AADSTS90009 jinak). api://<appId>

Zadejte tyto hodnoty při vytváření připojení a pak se přihlaste a odsouhlaste vystavený obor agenta. Vytvořte jedno připojení na agenta.

Aplikace také potřebuje delegovaná oprávnění k delegovanému oprávnění Microsoft Graph User.Read (Přihlášení a čtení profilu uživatele) se souhlasem. Bez něj přihlášení selže s AADSTS90008.

Pokud chcete vyměnit token pro podřízené rozhraní API, nakonfigurujte delegovaná oprávnění rozhraní API pro aplikaci agenta a získejte požadovaný souhlas uživatele nebo správce. Vystavení oboru ve vlastním rozhraní API agenta neuděluje podřízená oprávnění.

Známé problémy a omezení

Vstup agentEndpoint musí být úplná adresa URL HTTPS (například https://my-agent.azurewebsites.net). Konektor připojí /api/messages a přesměruje datovou část aktivity.
Konektor předá datovou část aktivity as-is a nenastaví deliveryMode. Agent odpoví asynchronně (normální doručení) tím, že aktivity odpovědi POSTing zpět serviceUrl na zadané příchozí aktivity (volající, např. Microsoft Copilot Studio, poskytuje zpětné serviceUrlvolání s klíčem SAS).
Připojení Microsoft Entra ID (přihlášení uživatele) vždy odesílá delegovaný token účtu přihlášeného k připojení, a to pro každé volání provedené tímto připojením, včetně hovorů jménem jiných lidí, kteří komunikují s agentem. Pro každého volajícího neodesílá samostatný token, takže se uživatel aktivity from může lišit od uživatele v tokenu. Autorizovat žádosti pouze jako účet v ověřeném tokenu a nezacházet s hlavičkami aktivity from ani žádosti jako s autoritou chatující osoby. Pokud agent musí fungovat jako každý uživatel, který s ním chatuje, nepoužívejte tento typ připojení.
Pokud je souhlas přihlášeného účtu odvolán nebo jeho relace už nejde aktualizovat, přihlaste se k připojení znovu.
Tento konektor je ve verzi Preview. Dostupnost a možnosti se můžou změnit.

Vytvoření připojení

Konektor podporuje následující typy ověřování:


Klíč rozhraní API	Ověřte se pomocí statického klíče rozhraní API, který cílový agent očekává ve vlastní hlavičce HTTP. Zadejte název hlavičky (například x-api-key) i jeho hodnotu.	Všechny oblasti	Nesdílitelné
Microsoft Entra ID (přihlašovací údaje klienta)	Nosné tokeny Mint OAuth z aplikace Microsoft Entra ID pomocí toku client_credentials. Cílová skupina nosný token (adresa URL prostředku) musí odpovídat cílové skupině očekávané cílovým agentem.	Všechny oblasti	Nesdílitelné
Microsoft Entra ID (přihlášení uživatele)	Přihlaste se prostřednictvím Microsoft Entra ID aplikace cílového agenta (tok autorizačního kódu) a odešlete delegovaný nosný token účtu přihlášeného uživatele. Každý hovor provedený pomocí tohoto připojení používá účet přihlášený k připojení, ne osobu, která chatuje s agentem. K výměně tokenu jménem uživatele potřebuje agent nakonfigurovaná jeho podřízená delegovaná oprávnění a souhlas.	Všechny oblasti	Nesdílitelné
Bez ověřování	Volání koncového bodu cílového agenta bez hlavičky ověřování Použijte ho jenom s agenty, kteří explicitně přijímají anonymní volání.	Všechny oblasti	Sdíletelný
Výchozí [ZASTARALÉ]	Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.	Všechny oblasti	Nesdílitelné

klíč rozhraní API

ID ověřování: apiKey

Použitelné: Všechny oblasti

Ověřte se pomocí statického klíče rozhraní API, který cílový agent očekává ve vlastní hlavičce HTTP. Zadejte název hlavičky (například x-api-key) i jeho hodnotu.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Název hlavičky klíče rozhraní API	řetězec	Název hlavičky HTTP, na které cílový agent očekává klíč rozhraní API (například x-api-key nebo Ocp-Apim-Subscription-Key).	Pravdivé
Hodnota klíče rozhraní API	Securestring	Hodnota klíče statického rozhraní API odeslaná při každém požadavku do koncového bodu cílového agenta.	Pravdivé

Microsoft Entra ID (přihlašovací údaje klienta)

ID ověřování: oauthClientCredentials

Použitelné: Všechny oblasti

Nosné tokeny Mint OAuth z aplikace Microsoft Entra ID pomocí toku client_credentials. Cílová skupina nosný token (adresa URL prostředku) musí odpovídat cílové skupině očekávané cílovým agentem.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Tenant	řetězec	ID tenanta aplikace Microsoft Entra ID	Pravdivé
ID klienta	řetězec	ID klienta (nebo aplikace) Microsoft Entra ID aplikace.	Pravdivé
Tajný klíč klienta	Securestring	Tajný klíč klienta aplikace Microsoft Entra ID.	Pravdivé
Adresa URL prostředku	řetězec	Cílová skupina tokenu OAuth. ID Microsoft aplikace cílového agenta (například API://< appId> nebo IDENTIFIKÁTOR GUID ID aplikace).	Pravdivé

ID ověřování: oauthAuthorizationCode

Použitelné: Všechny oblasti

Přihlaste se prostřednictvím Microsoft Entra ID aplikace cílového agenta (tok autorizačního kódu) a odešlete delegovaný nosný token účtu přihlášeného uživatele. Každý hovor provedený pomocí tohoto připojení používá účet přihlášený k připojení, ne osobu, která chatuje s agentem. K výměně tokenu jménem uživatele potřebuje agent nakonfigurovaná jeho podřízená delegovaná oprávnění a souhlas.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Tenant	řetězec	ID tenanta Microsoft Entra ID aplikace cílového agenta.	Pravdivé
ID klienta	řetězec	ID Microsoft aplikace cílového agenta. Použijte vlastní aplikaci agenta, aby mohl agent vyměnit delegovaný token jménem uživatele.	Pravdivé
Tajný klíč klienta	Securestring	Tajný klíč klienta Microsoft Entra ID aplikace cílového agenta.	Pravdivé
Adresa URL prostředku	řetězec	Cílová skupina delegovaného tokenu Musí to být ID Microsoft aplikace cílového agenta, stejná hodnota jako ID klienta: Microsoft Entra přijímá pouze identifikátor GUID, pokud aplikace požaduje token pro sebe.	Pravdivé

Bez ověřování

ID ověřování: anonymní

Použitelné: Všechny oblasti

Volání koncového bodu cílového agenta bez hlavičky ověřování Použijte ho jenom s agenty, kteří explicitně přijímají anonymní volání.

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

Výchozí [ZASTARALÉ]

Použitelné: Všechny oblasti

Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Akce

Odeslání aktivity do agenta

Přesměruje datovou část protokolu aktivity do koncového bodu agenta na adrese {agentEndpoint}/api/messages. Pokud připojení používá Microsoft Entra ID OAuth, cílová skupina tokenů (adresa URL prostředku v připojení) musí odpovídat cílové skupině očekávané cílovým agentem (vzor ověřování dovedností bot Frameworku); pokud se cílové skupiny liší, vytvořte pro každého agenta jedno připojení. Konektor předá datovou část aktivity as-is a nenastaví "deliveryMode"; agent odpoví asynchronně (normální doručení) aktivitami odpovědi POSTing na "serviceUrl" zadané pro příchozí aktivitu.

Odeslání aktivity do agenta

ID operace:: SendActivity

Parametry

Název	Klíč	Vyžadováno	Typ	Description
Adresa URL koncového bodu agenta	agentEndpoint	True	string	Základní adresa URL cílové sady SDK Microsoft agentů / koncového bodu služby Bot Framework (napříkladhttps://my-agent.azurewebsites.net). Konektor připojí /api/messages.
			object

Agent SDK (Preview)

Předpoklady

Získání přihlašovacích údajů

Microsoft Entra ID (přihlašovací údaje klienta)

Microsoft Entra ID (přihlášení uživatele)

Známé problémy a omezení

Vytvoření připojení

klíč rozhraní API

Microsoft Entra ID (přihlašovací údaje klienta)

Microsoft Entra ID (přihlášení uživatele)

Bez ověřování

Výchozí [ZASTARALÉ]

Akce

Odeslání aktivity do agenta

Parametry

Návraty

Definice

objekt