Ota käyttäjän tunnistautuminen käyttöön Copilot Agent Kitissä

Copilot Agent Kit tukee räätälöityjen agenttien testaamista käyttäjän tunnistautumisella, kun käytät Microsoft Entra ID v2:ta palveluntarjoajana SSO päällä. Yhteenvetona: luot ja konfiguroit tarvittavat sovellukset Azure-portaalissa ja luot agentin konfiguroinnin Copilot Agent Kitissä.

Käyttäjän tunnistautumisen mahdollistamiseksi Copilot Agent Kitissä:

  • Luo sovellusrekisteröinti erityisesti Copilot Agent Kit -todennustarkoituksiin.
  • Luo sovelluksen rekisteröinti Copilot Studio -todennusta varten.
  • Ota Copilot Studio -agentin todentaminen käyttöön.
  • Luo agentin konfiguraatio Copilot Agent Kitissä loppukäyttäjän todennus ollessa käytössä.
  • Yhdistä sovellukset niin, että Copilot Agent Kit voi tunnistautua Direct Line:lle Copilot Studio -todennuksella.

Prerequisites

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

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

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

Luo todennussovellus Copilot Agent Kitille

Luodaksesi todennussovelluksen Copilot Agent Kitille, seuraa ohjeita kohdassa Luo sovellusrekisteröinti Microsoft Entra ID:ssä räätälöidylle kankaallesi.

Huomioi ylimääräiset vaiheet:

  1. Luo sovelluksen rekisteröinti Microsoft Entra -tunnuksessa.

    (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 agenttirekisteröintiä Copilot Agent Kitiin ja liität Copilot Studio:n Copilot Agent 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.

Todennussovelluksen luominen Copilot Studiolle

Jos haluat luoda todennussovelluksen Copilot Studiolle, noudata kohdan Käyttäjän todentamisen määrittäminen Microsoft Entra -tunnuksella ohjeita.

Kirjoita muistiin suositellut lisävaiheet .

Kun luot sovelluksen rekisteröintiä:

  • Anna uudelle sovellukselle nimeksi CopilotStudioAuthApp.

  • Valitse Tuetut tilityypit -kohdassa Tilit missä tahansa organisaation vuokraajassa (mikä tahansa Microsoft Entra ID -hakemisto - useita) 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öön loppukäyttäjän todentamisen Copilot Studiossa. 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öön loppukäyttäjän todentamisen Copilot Studiossa.

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ämän arvon myöhemmin, kun otat käyttöön käyttäjän todentamisen Copilot Studiossa.

  • 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. Mene Copilot Agent Kit -kohtaan.
  2. Valitse siirtymisruudusta Agentit .
  3. Valitse Uusi.
  4. Kirjoita Nimi.
  5. Valitse Määritystyypit-kohdastaTestin automatisointi.
  6. Täytä Direct Line -asetukset. Ota Kanavan suojaus käyttöön ja anna Direct Line -salasana.
  7. Valitse Käyttäjän todentaminen -kohdassa 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 ja sulje.

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

  • Last updated on