Ügynök SDK (előzetes verzió)

A Bot Framework/Microsoft Agent SDK-tevékenység hasznos adatainak továbbítása a felhasználó által megadott ügynökvégpontra. Az ügynök végpontJÁNAK URL-címét hívásonként adja meg bemeneti paraméterként. A kapcsolat létrehozásakor a hitelesítés ki van választva: nincs hitelesítés, statikus API-kulcs vagy Microsoft Entra ID OAuth (client_credentials). Az OAuth kiválasztásakor a tulajdonosi jogkivonat célközönségének (a kapcsolaton konfigurált erőforrás URL-címének) meg kell egyeznie a célügynök által várt célközönségkel.

Ez az összekötő a következő termékekben és régiókban érhető el:

Szolgáltatás Class Regions
Copilot Studio Standard Az összes Power Automate régió kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Apps Standard Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate Standard Az összes Power Automate régió kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Kapcsolat
Név Microsoft
URL https://support.microsoft.com
Összekötő metaadatai
Publisher Microsoft
Webhely https://www.microsoft.com
Adatvédelmi irányelvek https://privacy.microsoft.com/
Categories Termelékenység

Az Ügynök SDK-összekötő továbbítja a Bot Framework/Microsoft Agent SDK-tevékenység hasznos adatait egy felhasználó által megadott ügynökvégpontra. Az ügynök végpontJÁNAK URL-címét hívásonként adja meg bemeneti paraméterként; Az OAuth-jogkivonatokat a platform a felhasználó által megadott Microsoft Entra ID a kapcsolaton konfigurált alkalmazás hitelesítő adataiból menti, és minden kimenő kéréshez tulajdonosi jogkivonatként injektálja. A tulajdonosi jogkivonat célközönségének (a kapcsolaton konfigurált erőforrás URL-címének) meg kell egyeznie a célügynök által várt célközönségkel.

Prerequisites

  • A HTTPS-en keresztül elérhető üzembe helyezett Microsoft Agent SDK/Bot Framework-ügynök.
  • Az ügynököt üzemeltető bérlőben regisztrált Microsoft Entra ID alkalmazás, amely a client_credentials célügynök meghívására vonatkozó engedélyekkel és engedélyekkel van konfigurálva.
  • Az ügynök várt jogkivonat-célközönsége (általában az ügynök Microsoft alkalmazásazonosítója, például api://<appId>).

Hitelesítő adatok lekérése

Az API-kérések hitelesítéséhez a következőkre lesz szüksége:

  1. A Microsoft Entra ID alkalmazás bérlőazonosítója.
  2. Az Microsoft Entra ID alkalmazás ügyfélazonosítója (alkalmazásazonosítója).
  3. Az alkalmazás titkos ügyfélkódja .
  4. Az erőforrás URL-címe , amely megfelel a célügynök által várt célközönségnek (Bot Framework skill auth pattern).

Adja meg ezeket az értékeket kapcsolat létrehozásakor. Hozzon létre egy kapcsolatot ügynökönként, ha a célközönségek eltérőek.

Ismert problémák és korlátozások

  • A agentEndpoint bemenetnek teljes HTTPS URL-címnek kell lennie (például https://my-agent.azurewebsites.net). Az összekötő hozzáfűzi /api/messages és továbbítja a tevékenység hasznos adatait.
  • Az összekötő továbbítja a tevékenység hasznos adatait as-is, és nem állítja be deliveryMode. Az ügynök aszinkron módon (normál kézbesítéssel) válaszol, ha a posTing választevékenységeket küld vissza a serviceUrl bejövő tevékenységhez (a hívó például Microsoft Copilot Studio SAS-kulcsú visszahívást serviceUrlbiztosít).
  • Ez az összekötő előzetes verzióban érhető el. A rendelkezésre állás és a képességek változhatnak.

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:
API-kulcs Hitelesítés egy statikus API-kulccsal, amit a célügynök elvár egy egyéni HTTP-fejlécben. Adja meg a fejléc nevét (például x-api-key) és értékét is. Minden régió Nem osztható meg
Microsoft Entra ID (ügyfél hitelesítő adatai) Mint OAuth-jogkivonatok egy Microsoft Entra ID alkalmazásból a client_credentials folyamat használatával. A tulajdonosi jogkivonat célközönségének (erőforrás URL-címének) meg kell egyeznie a célügynök által várt célközönségkel. Minden régió Nem osztható meg
Nincs hitelesítés Hívja meg a célügynök végpontját hitelesítési fejléc nélkül. Ezt csak olyan ügynökökkel használja, amelyek kifejezetten fogadnak névtelen hívásokat. Minden régió Megosztható
Alapértelmezett [ELAVULT] Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják. Minden régió Nem osztható meg

API-kulcs

Hitelesítési azonosító: apiKey

Alkalmazható: Minden régió

Hitelesítés egy statikus API-kulccsal, amit a célügynök elvár egy egyéni HTTP-fejlécben. Adja meg a fejléc nevét (például x-api-key) és értékét is.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Description Required
API-kulcs fejlécének neve karakterlánc Annak a HTTP-fejlécnek a neve, amelyen a célügynök az API-kulcsot várja (például x-api-key vagy Ocp-Apim-Subscription-Key). True
API-kulcs értéke securestring A célügynök végpontjának küldött minden kérés statikus API-kulcsértéke. True

Microsoft Entra ID (ügyfél hitelesítő adatai)

Hitelesítési azonosító: oauthClientCredentials

Alkalmazható: Minden régió

Mint OAuth-jogkivonatok egy Microsoft Entra ID alkalmazásból a client_credentials folyamat használatával. A tulajdonosi jogkivonat célközönségének (erőforrás URL-címének) meg kell egyeznie a célügynök által várt célközönségkel.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Description Required
Tenant karakterlánc A Microsoft Entra ID alkalmazás bérlőazonosítója True
Ügyfélazonosító karakterlánc Az Microsoft Entra ID alkalmazás ügyfél-(vagy alkalmazás-) azonosítója. True
Titkos ügyfélkód securestring Az Microsoft Entra ID alkalmazás titkos ügyfélkódja. True
Erőforrás URL-címe karakterlánc Az OAuth-jogkivonat célközönsége. Általában a célügynök Microsoft alkalmazásazonosítója (például api://< appId> vagy az alkalmazásazonosító GUID azonosítója). True

Nincs hitelesítés

Hitelesítési azonosító: névtelen

Alkalmazható: Minden régió

Hívja meg a célügynök végpontját hitelesítési fejléc nélkül. Ezt csak olyan ügynökökkel használja, amelyek kifejezetten fogadnak névtelen hívásokat.

Ez megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a kapcsolat is meg van osztva. További információ: Összekötők áttekintése vászonalapú alkalmazásokhoz – Power Apps | Microsoft Docs

Alapértelmezett [ELAVULT]

Alkalmazható: Minden régió

Ez a beállítás csak olyan régebbi kapcsolatokhoz használható, amelyeknek nincs explicit hitelesítési típusuk, és csak a visszamenőleges kompatibilitást biztosítják.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Műveletek

Tevékenység küldése ügynöknek

Az Activity Protocol hasznos adatait továbbítja az ügynök végpontjának a(z) {agentEndpoint}/api/messages címen. Ha a kapcsolat Microsoft Entra ID OAuth-ot használ, a jogkivonat célközönségének (a kapcsolat erőforrás-URL-címének) meg kell egyeznie a célügynök által várt célközönségmel (Bot Framework-képesség hitelesítési mintája); ügynökönként egy kapcsolatot kell létrehoznia, ha a célközönségek eltérőek. Az összekötő továbbítja a tevékenység hasznos adatait as-is, és nem állítja be a "deliveryMode" értéket; az ügynök aszinkron módon (normál kézbesítéssel) válaszol, ha a posTing választevékenységeket küld a bejövő tevékenységhez megadott "serviceUrl"-nek.

Tevékenység küldése ügynöknek

Műveletazonosító:
SendActivity

Az Activity Protocol hasznos adatait továbbítja az ügynök végpontjának a(z) {agentEndpoint}/api/messages címen. Ha a kapcsolat Microsoft Entra ID OAuth-ot használ, a jogkivonat célközönségének (a kapcsolat erőforrás-URL-címének) meg kell egyeznie a célügynök által várt célközönségmel (Bot Framework-képesség hitelesítési mintája); ügynökönként egy kapcsolatot kell létrehoznia, ha a célközönségek eltérőek. Az összekötő továbbítja a tevékenység hasznos adatait as-is, és nem állítja be a "deliveryMode" értéket; az ügynök aszinkron módon (normál kézbesítéssel) válaszol, ha a posTing választevékenységeket küld a bejövő tevékenységhez megadott "serviceUrl"-nek.

Paraméterek

Name Kulcs Kötelező Típus Description
Ügynökvégpont URL-címe
 agentEndpoint True string

A cél Microsoft Ügynökök SDK/Bot Framework végpontjának alap URL-címe (példáulhttps://my-agent.azurewebsites.net). Az összekötő hozzáfűzi az /api/üzeneteket.
object

Válaszok

response
object

Definíciók

objektum

Ez az "objektum" típus.