Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]
Voeg het onderdeel Agentrespons toe aan een modelgestuurd app-formulier, waarmee u rechtstreeks een Microsoft Copilot Studio-onderwerp kunt aanroepen en de respons aan de gebruiker kunt weergeven. Dit onderdeel bouwt voort op de methode executeEvent van de Agent-API en vereenvoudigt het gebruik door geen nieuw aangepast onderdeel te vereisen. De impliciete context van de app, pagina en record zijn beschikbaar in Copilot Studio.
Dit onderdeel ondersteunt de volgende responsen van Copilot Studio:
- Markdown
- Adaptieve kaart
- Image
- Video
Belangrijk
- Dit is een preview-functie.
- Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Voor deze functies gelden aanvullende gebruiksvoorwaarden. Bovendien zijn ze beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.
Voorwaarden
Vereist dat de instelling Gebruikers toestaan gegevens te analyseren met behulp van een door AI mogelijk gemaakt chatervaring in de omgeving van canvas- en modelgestuurde apps is ingeschakeld voor modelgestuurde apps. Meer informatie: Copilot-omgevingsinstellingen
Een agentresponscomponent toevoegen aan een formulier
Open de formulierontwerper om een formulier te maken of te bewerken. Meer informatie: Een formulier maken of Een formulier bewerken
Selecteer in de formulierontwerper Onderdeel op de opdrachtbalk.
Vouw in het deelvenster Onderdelen Kunstmatige intelligentie uit
Sleep Agentrespons naar het formuliercanvas.
Voer in het dialoogvenster Agentrespons toevoegen de Gebeurtenisnaam in via het onderwerp in Copilot Studio in het vak Statische waarde. Meer informatie: De gebeurtenisnaam voor een onderwerp zoeken in Copilot Studio
Notitie
De optie Binden aan tabelkolom wordt niet ondersteund voor dit onderdeel.
Selecteer Opslaan en publiceren op de opdrachtbalk.
Open het formulier in een modelgestuurde app om het onderdeel te testen.
Notitie
In de preview van de formulierontwerper wordt de waarschuwing 'Agentrespons is alleen beschikbaar wanneer u de app afspeelt' weergegeven, omdat live preview nog niet wordt ondersteund.
De gebeurtenisnaam voor een onderwerp zoeken in Copilot Studio
Open het onderwerp in Copilot Studio en zoek het knooppunt Trigger.
Controleer of het triggertype Er vindt een aangepaste clientgebeurtenis plaats of Gebeurtenis ontvangen is.
Selecteer in het knooppunt Trigger de optie Bewerken.
Kopieer in het deelvenster Eigenschappen bij gebeurtenisactiviteit de tekenreekswaarde van de eigenschap Gebeurtenisnaam die moet worden doorgegeven vanuit het onderdeel Agentrespons. Meer informatie: De trigger voor een onderwerp wijzigen
Toegang tot app-context
Wanneer met de component voor agentrespons het onderwerp Copilot Studio wordt aangeroepen, wordt context voor de app doorgegeven via een set variabelen. Hieronder staan contextvariabelen die beschikbaar zijn als globale variabelen van Copilot Studio.
| Variabele | Omschrijving |
|---|---|
Global.PA__Copilot_Model_PageContext.pageContext.id.guid |
ID van het tabelrecord op het hoofdformulier |
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName |
Logische naam van de tabel op de hoofdpagina |
Global.PA__Copilot_Model_PageContext.pageContext.pageName |
Naam van de hoofdpagina |
Global.PA__Copilot_Model_PageContext.pageContext.pageType |
Type van de hoofdpagina |
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName |
Unieke naam van de modelgestuurde app |
Toegankelijkheid
Wanneer de Copilot Studio-respons een adaptieve kaart is, zorg er dan voor dat de volgende best practices worden gevolgd voor een toegankelijke ervaring.
Beperkingen
Eigenschappen van agentresponscomponenten worden momenteel niet ondersteund:
- Etiket
- Label verbergen
- Op telefoon verbergen
- Vergrendelen
- Alleen-lezen
- Breedte van onderdeel
- Hoogte van onderdeel
- Binden aan tabelkolom
Het onderdeel Agentrespons biedt geen ondersteuning voor het doorgeven van extra context aan Copilot Studio. Maak een aangepast onderdeel met behulp van de methode executeEvent van de Agent-API om het doorgeven van meer context te ondersteunen.
Het onderdeel Agentrespons ondersteunt alleen een adaptieve kaart die alleen-lezen is. Maak een aangepast onderdeel met behulp van de methode executeEvent van de Agent-API om logica aan de clientzijde te ondersteunen.
Het onderdeel Agentrespons wordt niet ondersteund voor mobiele apparaten of tablets.
Verwante artikelen
Veelgestelde vragen over Agent-API's en het onderdeel Agentrespons
Overzicht van de modelgestuurde formulierontwerper
Onderdelen toevoegen, configureren, verplaatsen of verwijderen op een formulier