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). 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; Tokeny OAuth jsou vytěsněny platformou z uživatelem dodaného Microsoft Entra ID přihlašovací údaje aplikace nakonfigurované pro připojení a vloženy jako nosný token pro každý odchozí požadavek. Cílová skupina nosných tokenů (adresa URL prostředku nakonfigurovaná pro připojení) musí 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.
Aplikace Microsoft Entra ID zaregistrovaná v tenantovi, který je hostitelem agenta, nakonfigurovaná s oprávněním client_credentials udělit a volat cílového agenta.
Očekávaná cílová skupina tokenů agenta (obvykle ID aplikace Microsoft agenta).api://<appId>

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

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í.

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).
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é
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é

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

Name	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ů

Známé problémy a omezení

Vytvoření připojení

klíč rozhraní API

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

Bez ověřování

Výchozí [ZASTARALÉ]

Akce

Odeslání aktivity do agenta

Parametry

Návraty

Definice

objekt