Megosztás a következőn keresztül:

Továbbfejlesztett Microsoft Power Platform összekötők létrehozása SDK használatával (előzetes verzió)

[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]

A Microsoft Power Platform csatlakozók Software Development Kit (SDK) felszabadítja a strukturált adatokban rejlő lehetőségeket, így javíthatja belső munkafolyamatait, és felvértezheti ügynökeit ismeretekkel. Az SDK leegyszerűsíti a strukturált vállalati adatok továbbfejlesztett Power Platform összekötőinek létrehozásának folyamatát, amelyek lehetővé teszik a szervezet számára, hogy intelligensebb és környezettudatosabb élményben részesüljön. Az SDK használatával létrehozott összekötők hatékony tudásforrásként szolgálhatnak az ügynökök számára, és lehetővé teszik a vászonalapú alkalmazások egyszerű létrehozását Power Apps.

Az SDK tartalmaz egy keretrendszert, amely összetevőket és eszközöket tartalmaz, így a következőket teheti:

  • Könnyebben hozhat létre nagy teljesítményű, nagyvállalati szintű összekötőket.
  • Tesztelje, ellenőrizze és tanúsítsa az összekötőket az optimális integráció és megbízhatóság biztosítása érdekében.
  • Konfigurálja az összekötőt az ügynökök tudásforrásaként.

Az SDK-fájlok letölthetők a Microsoft power-fx-enhanced-connector GitHub-adattárából. Ez a cikk az SDK használatának megkezdéséhez szükséges előfeltételeket és lépéseket tartalmazza.

Fontos

  • Ez egy előnézeti funkció.
  • Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezekre a funkciókra kiegészítő használati feltételek vonatkoznak, és a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korai hozzáférést kaphassanak, és visszajelzést adhassanak.

Feljegyzés

Az SDK nyílt forráskódú, hogy ösztönözze Önt a használatára és visszajelzések megosztására, hogy folyamatosan tanulhassunk és javíthassunk. Kérdések, problémák vagy megbeszélések esetén használja a GitHub webhely Problémák vagy Vitafórumok lapját.

Előfeltételek

Az SDK használatához meg kell győződnie arról, hogy hozzáférhet és letöltheti az alábbi előfeltételeket:

1. lépés: A tároló klónozása

Klónozza a CDP minta webes API-projekttárat a GitHubról. Ez az adattár tartalmaz egy mintamegoldást, amely bemutatja, hogyan hozhat létre egyéni összekötőt az SDK használatával.

2. lépés: A megoldás összeállítása

A megoldás létrehozásához kövesse az alábbi lépéseket:

  1. Nyissa meg a klónozott adattárat a fejlesztői környezetben.
  2. Hozza létre a megoldást, biztosítva, hogy az összes függőségre megfelelően hivatkozzon, és a projekt sikeresen lefordítható. Megmutatja, hogy hol található a klónozott adattár. Visual Studio

3. lépés: A megoldás helyi hibakeresése

A megoldás helyi hibakereséséhez kövesse az alábbi lépéseket:

  1. Kattintson a jobb gombbal a CDP minta webes API-projektre a fejlesztői környezetben.
  2. Válassza a Hibakeresés lehetőséget a webalkalmazás helyi elindításához. Ez lehetővé teszi az API-végpontok tesztelését és annak biztosítását, hogy megfelelően működjenek. A meghívni kívánt végpontok mintafájljára CdpSampleWebApi.httphivatkozhat . http fájlra. Megjeleníti, hogy hol található a

4. lépés: Egyéni logika implementálása

Az egyéni logika megvalósításához kövesse az alábbi lépéseket:

  1. Nyissa meg a projekt Vezérlők és szolgáltatásokmappáját .

  2. Implementálja az egyéni logikát úgy, hogy lecseréli a mintaadatokat a háttér API-hívásaira a szükséges adatok lekéréséhez. Az első lépésekkel kapcsolatos további információkért látogasson el a következő oldalra:

    Megmutatja, hogy hol található a

5. lépés: API-végpontok tesztelése

Az API-végpontok teszteléséhez kövesse az alábbi útmutatást:

6. lépés: A webes API üzembe helyezése

A webes API üzembe helyezéséhez kövesse az alábbi lépéseket:

  1. Helyezze üzembe az egyéni webes API-t egy üzemeltetési környezetben (például Azure-ban vagy AWS-ben).
  2. Győződjön meg arról, hogy az üzembe helyezett API elérhető, és képes kezelni az egyéni összekötőtől érkező kéréseket.

7. lépés: Az egyéni összekötő létrehozása

Saját egyéni összekötő létrehozásához kövesse az alábbi lépéseket:

  1. Hozzon létre egy egyéni összekötőt a parancssori eszközzel (CLI).

  2. Nyissa meg a GitHub-adattár CdpSampleArtifacts mappáját a sample OpenAPI (swagger) és az API-tulajdonságfájlok használatához.

  3. Mutasson az egyéni összekötőre az üzembe helyezett webes API végpontjaira. Ez lehetővé teszi, hogy az összekötő a webes API-ban megvalósított egyéni logikán keresztül kommunikáljon a háttér API-val.

  4. Válassza ki az alábbi kódminták egyikét, amelyet hozzá szeretne adni a apiProperties.json táblázathoz, amikor összekötőt hoz létre vagy frissít a parancssori felületről:

    • Ha tudásforrásként szeretné hozzáadni ezt a továbbfejlesztett összekötőt:
    {
  "capabilities": ["tabular", "federatedKnowledgeSource"],
  "interfaces": {
    "CDPTabular1": {
      "revisions": {
        "1": {
          "baseUrl": "/",
          "status": "Production"
        }
      }
    }
  }
}
    • Ha nem szeretné hozzáadni ezt a továbbfejlesztett összekötőt tudásforrásként:
    {
  "capabilities": ["tabular"],
  "interfaces": {
    "CDPTabular1": {
      "revisions": {
        "1": {
          "baseUrl": "/",
          "status": "Production"
        }
      }
    }
  }
}

8. lépés: Hitelesítés konfigurálása

A hitelesítés konfigurálásához kövesse az alábbi lépéseket:

  1. Adjon hozzá hitelesítési mechanizmusokat a webes API-hoz a végpontok biztonságossá tételéhez (a követelmények alapján).
  2. Konfigurálja az egyéni összekötőt úgy, hogy a megfelelő hitelesítési módszert használja a webes API eléréséhez.

A Hitelesítés azonosítóval Microsoft Entra című témakörből megtudhatja, hogyan engedélyezheti a hitelesítést az azonosítóban Microsoft Entra .

9. lépés: Az összekötő megosztása és tesztelése

Az összekötő megosztásához és teszteléséhez kövesse az alábbi lépéseket:

  1. Ossza meg az egyéni összekötőt Power Platform.

  2. Tesztelje az összekötőt olyan mintaalkalmazások vagy folyamatok létrehozásával, amelyek az összekötőt használják a háttér API-val való interakcióhoz. Az első lépésekhez látogasson el a következő oldalra:

Visszajelzés megosztása

Az SDK nyílt forráskódú, hogy ösztönözze Önt a használatára és visszajelzések megosztására, hogy folyamatosan tanulhassunk és javíthassunk. Kérdések, problémák vagy megbeszélések esetén használja a GitHub webhely Problémák vagy Vitafórumok lapját.

Kapcsolódó információk

A webes API-k használatáról az Azure API Management dokumentációjában talál további információt.

További információ az egyéni összekötők Copilot Studio létrehozásáról, Power Platform és Azure Logic Apps összekötők dokumentációja.