Microsoft Copilot uitbreiden met connectoracties (preview)

Met connectoracties kunt u connectors definiëren die kunnen worden aangeroepen vanuit AI-oppervlakken in Power Platform. Voor connectoracties moet u de acties identificeren die zijn ingeschakeld voor gebruik in Copilot. U kunt ook de informatie vastleggen die grote taalmodellen nodig hebben om de invoegtoepassing effectief te identificeren en te gebruiken, zoals samenvattings- en beschrijvingsvelden.

Vereisten

Er moet aan een aantal vereisten worden voldaan om Microsoft-copilot-ervaringen met connectoracties uit te breiden.

Algemene vereisten

Voor alle Copilot-typen moet u beschikken over referenties op makerniveau, een copilot-licentie en een Microsoft Teams-licentie.

Vereisten voor Dynamics 365 Customer Service en Copilot voor Sales

Voor Copilot voor Dynamic 365 klantenservice en Copilot voor Sales moet u zijn aangemeld bij een omgeving die het Copilot-exemplaar bevat dat u wilt uitbreiden.

Vereisten voor Copilot voor Sales

• Salesforce-klanten moeten zijn aangemeld bij hun Dataverse-omgeving (de omgeving heet meestal msdyn_viva).
• U moet voorafgaand aan de uitbreiding al minstens één keer zijn aangemeld bij Copilot voor Sales via Outlook in de omgeving die u wilt uitbreiden.

Een connectoractie toevoegen

Het toevoegen van een connectoractie aan een Microsoft-copilot omvat een aantal stappen. De volgende secties bieden richtlijnen voor het toevoegen van een connectoractie aan Copilot voor Microsoft 365, Copilot voor Sales en Copilot voor Dynamics 365 Customer Service.

De Copilot-ervaring selecteren en connectoractie kiezen

1. Selecteer Copilots op de startpagina.

   

2. Selecteer in de lijst Copilots in het navigatievenster links de Microsoft-copilot-ervaring die u wilt uitbreiden.

   

   De overzichtspagina voor de Copilot-versie wordt weergegeven.

   

3. Afhankelijk van de Copilot-versie die u hebt geselecteerd, selecteert u het tabblad Acties of Extensies. U ziet een lijst met de acties die al aanwezig zijn in Copilot.

4. Kies er vervolgens voor om Copilot uit te breiden met een actie.

   Voor Copilot voor Microsoft 365 selecteert u Extensie toevoegen en vervolgens Nieuwe actie.

   Voor andere Copilot-typen selecteert u Actie toevoegen.

   

   Er wordt een lijst met alle ondersteunde actietypen voor Copilot weergegeven.

   

5. Selecteer Connector om uit te breiden met een connectoractie.

   De pagina Uw connector selecteren wordt weergegeven. Er wordt een lijst met beschikbare connectortypen weergegeven waaruit u kunt kiezen.

   Connectors verbinden copilots met verschillende services. De lijst bevat alle gecertificeerde connectors die Microsoft aanbiedt.

   Afhankelijk van de Copilot-versie kan de lijst ook aangepaste connectors bevatten die aanwezig zijn in de huidige omgeving die wordt gebruikt. Via de zoekbalk kunt u de connector vinden die u wilt gebruiken.

   Notitie

   Op dit moment kunnen aangepaste connectoren niet worden gebruikt om Copilot voor Dynamics 365 Customer Service uit te breiden.

Connectortype en een oplossing selecteren

1. Zoek uw connectortype met behulp van de zoekbalk en selecteer het.

   

   De pagina Een aangepaste AI-actie maken met behulp van uw connector wordt weergegeven.

2. Schrijf een naam en een beschrijving voor uw connector.

   De connectornaam moet uniek zijn. Standaard krijgt deze de naam van het gekozen connectortype. U moet meer definiërende informatie toevoegen om ervoor te zorgen dat de naam uniek is en gemakkelijk kan worden afgeleid wat de connector doet voor gebruikers die deze later willen inschakelen. Overweeg om in de beschrijving op te nemen welke typen acties mogelijk zijn, zoals 'Met een mailservice kunt u berichten ophalen en maken'.

   

   De beschrijving wordt mogelijk verstrekt als deze aanwezig is in de connector die u hebt geselecteerd. De beschrijving wordt door de Copilot gebruikt om te identificeren wanneer de actie kan worden gebruikt om responsen terug te krijgen op het gebruikersverzoek. Maak de beschrijving zo gedetailleerd en beschrijvend mogelijk. Geef specifieke details op met behulp van termen waarvan u verwacht dat gebruikers deze gebruiken wanneer ze de actie gebruiken. Om door te gaan op het voorbeeld van de mailservice hierboven, kunt u zoiets toevoegen als:

   'Mailservice biedt de mogelijkheid om lijsten met bestaande berichten te downloaden, mappen op te halen waarin berichten zijn opgeslagen, titels van berichten en mappen weer te geven, berichten te downloaden berichttitels en -teksten bij te werken, prioriteit voor berichten in te stellen.'

   De beschrijving laat Copilot weten dat de actie moet worden gebruikt zonder expliciete instructies te krijgen, waardoor een meer natuurlijke taalervaring mogelijk is.

3. In een vervolgkeuzelijst onder Oplossing worden alle oplossingen weergegeven die beschikbaar zijn in de huidige omgeving. Selecteer de oplossing die u wilt gebruiken. Zie voor meer informatie over wat oplossingen zijn en waarvoor u ze kunt gebruiken Oplossingsconcepten.

   

   Als u een voorkeursoplossing hebt of als de door u geselecteerde connector al in de oplossing is opgenomen, wordt die oplossing automatisch geselecteerd. U kunt een oplossing selecteren of niets invullen. Als u voor de oplossing niets invult, wordt er een oplossing voor u gemaakt met actienaam en standaarduitgever. Door uw actie in een oplossing op te slaan, kunt u deze gemakkelijk tussen omgevingen verplaatsen.

   Notitie

   In dit geval ziet u de standaardoplossing of CDS-standaardoplossing niet als optie, omdat we u aanraden een aangepaste oplossing te gebruiken voor eenvoudig beheer. Voor meer informatie, zie: Standaardoplossing vs. aangepaste oplossing.

4. Kies een oplossing en selecteer Volgende.

   De pagina Uw invoegtoepassingsactie selecteren en configureren wordt weergegeven. Op deze pagina worden alle acties weergegeven die kunnen worden toegevoegd voor uw connector. U kunt één voor één de acties selecteren en configureren die uw copilot moet ondersteunen. Via de zoekbalk kunt u de actie zoeken die u wilt selecteren. Er geldt geen limiet voor het aantal acties dat u kunt selecteren voor de connector.

   

Acties toevoegen aan de connector

Vervolgens moet u een keuze maken uit de beschikbare acties die u aan de connector wilt toevoegen.

Notitie

Connectors kunnen alleen de acties uitvoeren die u hier specifiek selecteert en configureert. Als een actie niet wordt vermeld, is deze niet beschikbaar. Het is niet mogelijk om vanuit de Copilot Studio-actiewizard acties toe te voegen aan of te verwijderen uit een connector.

1. Selecteer een actie om door te gaan. De pagina Uw invoegtoepassingsactie configureren wordt weergegeven voor die gekozen actie.

   

2. Geef een naam en beschrijving op voor uw actie. De naam hoeft in dit geval niet uniek te zijn. Deze waarden worden hoogstwaarschijnlijk voor u ingevuld via de connector. Net als bij de beschrijving van de connector moet u een gedetailleerde en specifieke beschrijving geven, zodat de copilot weet wanneer de specifieke actie moet worden aangeroepen. De beschrijving helpt een meer natuurlijke taalbenadering mogelijk te maken bij het selecteren van de uit te voeren actie. Als een actie bijvoorbeeld 'Berichtmappen weergeven' is, kunt u het volgende gebruiken:

   'Met Berichtmappen weergeven kunt u een lijst met alle berichtmappen ontvangen die beschikbaar zijn via de e-mailservice. Met deze actie worden alle mappen opgehaald en worden deze in een lijstweergave geplaatst en aan u geretourneerd.'

   Deze actiebeschrijving biedt de contextaanwijzingen 'berichtmappen weergeven', 'ophalen', 'alles', 'weergeven', 'mailservice', 'retourneren', 'mappen' en 'weergeven'. Uw copilot kan deze contextaanwijzingen gebruiken om te bepalen wanneer de actie de juiste is voor een gebruikersaanvraag.

3. Nadat u de pagina hebt voltooid, selecteert u Volgende. De pagina Parameters van uw actie controleren wordt weergegeven.

4. Selecteer Volgende om door te gaan.

   U keert terug naar de pagina Uw invoegtoepassingsactie selecteren en configureren waar u eerder ook al was. U ziet de nieuwe actie die u hebt geselecteerd.

   

5. Selecteer een andere actie en herhaal indien gewenst de vorige actieconfiguratiestappen.

   Of selecteer Volgende. Het scherm Uw actie beoordelen, testen en publiceren wordt weergegeven.

   

   Op de pagina Uw actie beoordelen, testen en publiceren worden de details van alle configuratiestappen tot nu toe weergegeven. U kunt deze bekijken en vervolgens uw actie testen vóór publicatie.

Testen

Nu u uw connectoractie hebt geconfigureerd, kunt u deze testen.

Notitie

Op dit moment biedt Copilot in Dynamics 365 for Customer Service geen ondersteuning voor het uitvoeren van tests vanuit de wizard voor het maken van connectoracties. Wanneer deze functie beschikbaar wordt, kunt u de invoegtoepassing via dit scherm testen. Voorlopig moeten gebruikers de invoegtoepassing publiceren en vervolgens kunnen ze valideren dat deze binnen de Copilot in Dynamics 365 for Customer Service functioneel is, direct nadat deze is ingeschakeld door een beheerder.

1. Selecteer uw bestaande verbinding in de vervolgkeuzelijst of selecteer + Nieuwe verbinding als u geen verbinding hebt.

   Als u +Nieuwe verbinding selecteert, wordt er een wizard geopend waarin u details kunt toevoegen om de verbinding te maken. Wanneer u klaar bent, kunt u de nieuwe verbinding selecteren in de vervolgkeuzelijst.

2. Wanneer u een verbinding hebt geselecteerd, selecteert u Actie testen.

3. Wanneer u een bericht ziet dat de actie is om te worden getest, selecteert u Openen om te testen om de Copilot-chat in een nieuw venster te openen. Open de flyout om de actie te zien en schakel deze in.

   De actie wordt weergegeven met een bekerpictogram onder de gekozen connector met de indeling Test-Actienaam.

4. U kunt de invoegtoepassing nu testen door de prompts uit te proberen die u van een gebruiker verwacht. U kunt ook de opdracht –developer on gebruiken voor meer informatie over de promptuitvoering. Als u tevreden bent over de resultaten gaat u terug naar het Copilot Studio-venster.

Publiceren

1. Als u klaar bent met testen, selecteert u Publiceren.

   Er wordt een pagina weergegeven waarop uw connector wordt weergegeven terwijl deze wordt gepubliceerd. Eenmaal voltooid, ziet u een pagina waarop wordt aangegeven dat uw connector is gepubliceerd.

2. Selecteer Naar detailpagina gaan om de details van de gepubliceerde connector te bekijken.

   Notitie

   Nu uw connector is gepubliceerd, moet een beheerder deze inschakelen voordat deze in de copilot kan worden gebruikt. Als u de connector niet in de copilot ziet, controleer dan of de connector is ingeschakeld via Microsoft Beheercentrum of op de pagina met copilot-extensies. Zodra de connector correct is ingeschakeld, wordt deze weergegeven in het uitklapmenu. De eerste keer dat je dit doet, kan het tot 24 uur duren voordat stap is voltooid.

3. Ook kunt u met een connector eenvoudig een actie van de ene omgeving naar de andere verplaatsen. Selecteer hiervoor Oplossing exporteren op de detailpagina. Als u de oplossing exporteert, kunt u de connector exporteren.

   

4. Wijzig zo nodig het versienummer en geef op of de oplossing Beheerd of Onbeheerd moet zijn.

   • Beheerd betekent dat u niet verwacht dat u verdere wijzigingen in de oplossing hoeft aan te brengen.
   • Onbeheerd betekent dat u wijzigingen wilt aanbrengen in de oplossing in de doelomgeving.

5. Bij voltooiing ziet u een groen bericht met de optie om de oplossing te downloaden, waarmee een zipbestand wordt opgeslagen op uw systeem.

   Notitie

   U bent niet verplicht om Publiceren te selecteren in het oplossingenpaneel.

6. Ga terug naar de Copilot-pagina Acties/Extensies in Copilot Studio en selecteer Oplossing importeren in de doelomgeving.

   

7. Blader naar en selecteer het zipbestand voor uw geëxporteerde oplossing en selecteer Volgende om door te gaan. U kunt de connector in de lijst Acties/Extensies zien.

Een connectoractie verwijderen

Als u een connectoractie wilt verwijderen, voert u de volgende procedure uit.

Zoek de oplossing die door de connectoractie wordt gebruikt

De procedure om een connectoractie te verwijderen, wordt uitgevoerd in de Power Apps Maker-portal. U hebt echter de oplossing nodig die voor de connectoractie is gebruikt Copilot Studio.

1. Open Copilot Studio.

2. Selecteer de omgeving die gebruikt is om de connectoractie te maken.

3. Selecteer onder Copiloten de copilot waar de connectoractie is gemaakt.

4. Selecteer het tabblad Acties om de lijst met acties te bekijken die aan de Copilot zijn gekoppeld.

5. Selecteer de actie die u wilt verwijderen en noteer de naam van de oplossing.

   

Connector verwijderen in Power Apps Maker-portaal

1. Ga naar de Maker-portal (https://make.powerapps.com) en selecteer de omgeving die je in Copilot Studio hebt gebruikt om acties te maken.

2. Selecteer in het navigatiepaneel Oplossingen om de lijst met oplossingen in omgeving te bekijken.

3. Zoek de oplossing die u hebt gebruikt om de actie te maken en selecteer deze.

   Er wordt een lijst met objecten weergegeven die aan de oplossing zijn gekoppeld.

4. Zoek de connectoractie die u wilt verwijderen. De actie is van het type AIPlugin.

   Fooi

   Als u uw actie niet in de oplossing ziet, verplaatst u de actie van de status concept naar de status gereed door deze te publiceren.

5. Voordat u de actie verwijdert, moet u de afhankelijkheid van de tabel AICopilot_AIPlugin verwijderen. Selecteer eerst Geavanceerd>Afhankelijkheden weergeven.

   

   De afhankelijkheden voor de connectoractie worden weergegeven.

6. Selecteer Verwijderen voor de vermelding AICopilot_AIPlugin in de afhankelijkheidslijst.

   

7. Ga terug naar de lijst met objecten en verwijder de actie door Verwijderen>Verwijderen uit deze omgeving te selecteren.

   

8. Verwijder alle bewerkingen van het type AIPluginOperation in de tabel door Remove>Delete from this omgeving te selecteren.

   

9. Ga terug naar Copilot Studio om te controleren of de actie is verwijderd uit de Acties weergave voor de Copilot.

Notitie

Met deze procedure wordt de plug-in uit de Copilot-lijst verwijderd. Hiermee worden echter geen verbindingen verwijderd die zijn gemaakt met gegevensbron.