Jaa

Ota käyttäjien todentaminen käyttöön Copilot Studio Kitissä

Copilot Studio Kit tukee mukautettujen agenttien testaamista käyttäjän todentamisen avulla, kun käytät Entra ID -tunnus v2:ta palveluntarjoajana kertakirjautumis käytössä. Yhteenvetona voit luoda ja määrittää tarvittavat sovellukset Azure portaalissa ja luoda sitten agenttimääritykset Copilot Studio Kitissä.

Käyttäjän todentamisen ottaminen käyttöön Copilot Studio Kitissä:

  • Luo sovelluksen rekisteröinti erityisesti Copilot Studio Kit -todennusta varten.
  • Luo sovelluksen rekisteröinti Copilot Studio todentamista varten.
  • Ota Copilot Studio agentin todentaminen käyttöön.
  • Luo agentin määritys Copilot Studio Kitissä siten, että käyttäjän todentaminen on käytössä.
  • Linkitä sovellukset niin, että Copilot Studio Kit voi todentautua Direct Line Copilot Studio todentamisella.

Edellytykset

  • Asenna Copilot Studio Kit, jos et vielä sitä ole tehnyt.
  • Luo sovelluksen rekisteröinnit asianmukaisilla käyttöoikeuksilla vuokraajassasi.

Suosittelemme, että käytät seuraavia arvoja seuraavissa määritysvaiheissa:

  • Copilot Studio Kit -todennussovellus: KitAuthApp
  • Copilot Studio todennussovellus: CopilotStudioAuthApp
  • Copilot Studion käyttöalue: copilot.studio.scope

Todentamissovelluksen luominen Copilot Studio Kitille

Jos haluat luoda todennussovelluksen Copilot Studio Kitille, noudata Luo sovelluksen rekisteröinti Microsoft Entra ID mukautettua pohjaa varten.

Huomioi ylimääräiset vaiheet:

  1. Luo sovelluksen rekisteröinti Microsoft Entra ID.

    (Suositus) Anna uudelle sovellukselle nimeksi KitAuthApp.

    Merkitse rekisteröintiprosessin aikana muistiin hakemiston (vuokraajan) tunnus ja sovelluksen (asiakkaan) tunnus. Tarvitset näitä arvoja myöhemmin, kun luot agentin rekisteröintiä Copilot Studio Kitissä ja liität Copilot Studio Copilot Studio Kit -sovellukseen. Saat nämä tunnukset aina sovelluksen rekisteröinnin Yleiskatsaus-sivulta.

  2. Lisää uudelleenohjauksen URL-osoite.

    Muista osoittaa Dataverse-ympäristön URL-osoitteeseen. esimerkiksi https://<hostname>.crm.dynamics.com

  3. Siirry ylimääräisenä vaiheenakohtaan Varmenteet ja salaiset koodit ja luo uusi asiakassalaisuus.

    (Suositus) Anna salaisen KitAuthApp-salaisuuden nimeksi.

    Tallenna tämän salaisen koodin arvo suojattuun väliaikaiseen tiedostoon. Sitä tarvitaan, kun myöhemmin määrität agentin todennuksen.

  4. Valitse ohjelmointirajapinnan käyttöoikeuksistaMyönnä järjestelmänvalvojan suostumus vuokraajasi nimelle <>ja valitse sitten Kyllä. Jos painike ei ole käytettävissä, sinun on ehkä pyydettävä vuokraajan järjestelmänvalvojaa antamaan se puolestasi.

Todentamissovelluksen luominen Copilot Studio

Jos haluat luoda todentamissovelluksen Copilot Studio varten, noudata Todennuksen määrittäminen Microsoft Entra ID avulla.

Kirjoita muistiin suositellut lisävaiheet .

Kun luot sovelluksen rekisteröintiä:

  • Anna uudelle sovellukselle nimeksi CopilotStudioAuthApp.

  • Valitse Supported-tilityypit -kohdassa Tilit missä tahansa organisaation vuokraajassa (mikä tahansa Microsoft Entra ID-hakemisto – monivuokraaja) ja henkilökohtaiset Microsoft tilit (esimerkiksi skype, Xbox).

  • Kirjoita muistiin hakemiston (vuokraajan) tunnus ja sovelluksen (asiakkaan) tunnus. Tarvitset näitä arvoja myöhemmin, kun otat käyttäjän todentamisen käyttöön Copilot Studio. Saat nämä tunnukset aina sovelluksen rekisteröinnin Yleiskatsaus-sivulta.

Manuaalista todentamista määritettäessä:

  • Käytä asiakassalaisuuksia yhdistettyjen tunnistetietojen sijaan. Pane asiakasohjelman salasana -arvo muistiin. Tallenna se turvalliseen väliaikaiseen tiedostoon. Tarvitset sitä myöhemmin, kun otat käyttäjän todentamisen käyttöön Copilot Studio.

Kun määrität agentillesi mukautettua vaikutusaluetta:

  • (Suositus) Käytä vaikutusalueen nimessäcopilot.studio.scope-vaikutusaluetta.

  • Kirjoita vaikutusalueen koko nimi muistiin Kohdassa Alueet (muoto, joka on samankaltainen api://xxx/copilot.studio.scopekuin ). Tarvitset tätä arvoa myöhemmin, kun otat käyttäjän todentamisen käyttöön Copilot Studio.

  • Suorita nämä lisävaiheet:

    1. Valitse Lisää asiakassovellus.
    2. Anna Asiakastunnus-kohtaan aiemmin luomasi KitAuthApp-sovelluksen asiakastunnus .
    3. Varmista, että aiemmin luomasi vaikutusalue Valtuutetut alueet -laajuudessa (copilot.studio.scope). Ota käyttöön tämä vaikutusalue.
    4. Valitse Lisää sovellus.

Ota käyttöön loppukäyttäjän todentaminen mukautetussa agentissasi

Jos haluat ottaa käyttöön käyttäjän todentamisen mukautetulle agentillesi, toimi seuraavasti:

  1. Valitse Copilot Studio kohdassa SettingsSecurity > Authentication.
  2. Valitse Todenna manuaalisesti.
  3. Valitse Edellytä käyttäjiä kirjautumaan sisään.
  4. Älä muuta uudelleenohjauksen URL-osoitetta. Varmista, että Service provider on Microsoft Entra ID V2, jonka asiakassalaisuudet ovat.
  5. Anna Asiakastunnus-kohtaanAsiakastunnus lle CopilotStudioAuthApp.
  6. Anna Asiakassalaisuus-kohtaanasiakassalaisuus , joka on luotu sovellukselle CopilotStudioAuthApp.
  7. Syötä Token exchange URL-osoitteeseen laajuuden koko nimi (samassa muodossa kuin api://xxx/copilot.studio.scope), joka on luotu CopilotStudioAuthApp.
  8. (Valinnainen, pakollinen SharePoint tietolähteelle) Lisää ScopesFiles.Read.All.
  9. (Valinnainen, pakollinen SharePoint tietolähteelle) Lisää ScopesSites.Read.All.
  10. Valitse Tallenna ja valitse sitten valintaikkunassa uudelleen Tallenna .
  11. Sulje asetukset.
  12. Valitse Julkaise ja valitse sitten valintaikkunassa Julkaise uudelleen.

Agentin määrityksen luominen käyttäjän todentamisen ollessa käytössä

Jos haluat luoda agentin määrityksen, kun käyttäjän todentaminen on käytössä, toimi seuraavasti:

  1. Siirry kohtaan Copilot Studio Kit.
  2. Valitse siirtymisruudusta Agentit .
  3. Valitse Uusi.
  4. Kirjoita Nimi.
  5. Valitse Määritystyypit-kohdastaTestin automatisointi.
  6. Täytä asetukset Direct Line Settings. Ota Channel Security käyttöön ja anna Direct Line salasana.
  7. Jos käytössä on User Authentication, valitse Entra ID -tunnus v2.
  8. Anna Asiakastunnus-kohtaan KitAuthApp-sovelluksen asiakastunnus .
  9. Anna vuokraajatunnukselle KitAuthApp-sovelluksen hakemistotunnus .
  10. Anna Scope-kohtaan koko vaikutusalueen nimi (muoto samankaltainen kuin api://xxx/copilot.studio.scope), joka on luotu CopilotStudioAuthApp varten.
  11. Valitse Tallenna & sulje.

Olet nyt valmis testaamaan agenttiasi, kun loppukäyttäjän todennus on käytössä.

  • Last updated on