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.
De startpagina van de agent is de belangrijkste landingsweergave voor een agent. Dat is waar gebruikers hun interactie beginnen in een afgebakende omgeving. Deze bevat doorgaans de naam, het pictogram en de toeschrijving van de agent en kan andere elementen bevatten op basis van het doel, zoals eerdere interacties, dashboards of mediagalerieën, om context en snelle toegang tot relevante functies te bieden.
Het goed krijgen van deze fundamentele elementen is essentieel. Ze stellen identiteit vast, stellen verwachtingen in en signaleren vertrouwen voordat het eerste bericht wordt verzonden.
De startpagina van de agent bestaat uit verschillende afzonderlijke elementen. Elk element speelt een specifieke rol bij het begrijpen en benaderen van de agent.
| Element | Description |
|---|---|
| Titelbalk | Geeft basisagentinformatie, navigatie en basisopties weer. |
| Pictogram | Het brandingelement van de agent, waardoor deze gemakkelijker door gebruikers kan worden herkend. |
| Name | De unieke id of titel van de agent, zodat gebruikers het doel of de functie ervan kunnen herkennen. |
| Attribution | Geeft de middelen of organisatie achter de agent weer, zodat gebruikers de echtheid en betrouwbaarheid ervan kunnen verifiëren. |
| Invoervak voor chat | De belangrijkste manier om gebruikers te laten communiceren met de agent, zodat ze query's of opdrachten kunnen invoeren. Het invoervak voor chats volgt dezelfde richtlijnen als systeemeigen Microsoft 365 Chat, waardoor een consistente ervaring wordt gegarandeerd. |
| Starters voor prompt | Kort, klikbare suggesties die worden weergegeven op het welkomstscherm van de agent voordat een gebruiker iets typt. Ze begeleiden gebruikers over hoe ze kunnen beginnen en wat de agent kan doen. |
Icon
Het pictogram is het eerste visuele signaal dat gebruikers aan uw agent koppelen. Het moet duidelijk, doelgericht en consistent zijn met uw merk.
Volg deze richtlijnen bij het ontwerpen van uw agentpictogram:
- Gebruik een eenvoudige, herkenbare afbeelding die het doel van de agent weerspiegelt.
- Zorg ervoor dat het pictogram werkt op kleine grootten. Deze wordt weergegeven in compacte UI-oppervlakken zoals de titelbalk, chatkiezer en agentopslag.
- Vermijd tekst in het pictogram. Namen worden afzonderlijk geïdentificeerd.
- Volg de richtlijnen voor het pictogram van de Teams-app voor de vereisten voor grootte, vorm en kleur.
Note
Pictogrammen maken deel uit van uw app-pakket. Zorg ervoor dat uw pictogrammenassets voldoen aan de vereisten voor de Teams Store voordat u publiceert. Meer informatie vindt u in de validatierichtlijnen voor agents.
Name
De naam is de unieke identificatie die gebruikers overal in de agentervaring zien—in de titelbalk, de agentselectie, de chatgeschiedenis en de agentwinkel. Het moet meteen duidelijk maken wat het doel van de agent is.
Volg deze richtlijnen bij het benoemen van uw agent:
- Gebruik een duidelijke, beknopte naam die overeenkomt met de functie of het domein van de agent. Bijvoorbeeld: Contoso Ticket Manager of Sales Pipeline Agent.
- Vermijd superlatieve claims zoals 'beste', 'geweldig' of '#1'.
- Vermijd te veel algemene namen die de agent niet onderscheiden van anderen.
- Voor declaratieve agents moet de
namewaarde inmanifest.json, het JSON-bestand van de declaratieve agent enname_for_humanin alle JSON-invoegtoepassingsbestanden identiek zijn. - Gebruik geen instructietermen, URL's, emoji's of verborgen tekens in de naam.
Important
De agentnaam in de gebruikersinterface moet exact overeenkomen met de naam die is gedefinieerd in het manifest. Inconsistentheden kunnen validatiefouten veroorzaken bij het publiceren in de Store.
Naamsvermelding
Toeschrijving geeft de uitgever of organisatie achter de agent weer. Deze wordt weergegeven op de startpagina van de agent en helpt gebruikers bij het verifiëren van de bron van de agent voordat ze ermee in contact komen.
Duidelijke bronvermelding bevordert het vertrouwen van gebruikers. Gebruikers die kunnen identificeren wie een agent heeft gebouwd en die entiteit verantwoordelijk houden, hebben waarschijnlijk meer vertrouwen. Deze vertrouwensrelatie is vooral belangrijk in bedrijfsomgevingen waar agents gevoelige werkstromen of gegevens kunnen verwerken.
Zorg ervoor dat uw vermelding overeenkomt met de daadwerkelijke organisatienaam zoals geregistreerd in Partner Center. Vermijd misleidende kernmerken waaruit zou kunnen worden afgeleid dat een onafhankelijk gepubliceerde agent een door Microsoft ontwikkelde of first-party agent is.
Starters voor prompt
Promptstarters zijn korte, klikbare suggesties die worden weergegeven op het welkomstscherm van de agent. Ze begeleiden gebruikers bij zinvolle interacties voordat ze iets typen.
Effectieve starters voor prompt:
- Echte gebruiksvoorbeelden weergeven. Elke starter moet overeenkomen met een taak die de agent daadwerkelijk kan voltooien.
- Gebruik eenvoudige, actiegerichte taal. Begin met een werkwoord of een duidelijke vraag. Vermijd jargon.
- Bedek een scala aan mogelijkheden van de agent. Cluster niet alle starters rond één functie.
- Houd ze kort. Elke promptstart mag niet langer zijn dan 128 tekens.
First-run-gebruikerservaring
Wanneer een gebruiker uw agent voor het eerst gebruikt, worden op de startpagina het pictogram, de naam, de bronvermelding en promptstarters van de agent weergegeven. Er is geen gespreksgeschiedenis aanwezig. Dit is het moment om een sterke eerste indruk te maken.
De eerste gebruikservaring zou het volgende moeten doen:
- Bepaal onmiddellijk identiteit en doel. Gebruikers moeten weten wat de agent doet binnen enkele seconden na aankomst.
- Verlaag de barrière om te beginnen. Promptstarters verwijderen het probleem met een lege prompt door gebruikers concrete, vertrouwde toegangspunten te geven.
- Stel nauwkeurige verwachtingen in. De combinatie van naam, attributie en startprompts moet samen duidelijk maken wat de agent wel en niet kan doen.
Voor meer richtlijnen over het ontwerpen van eerste gebruikservaringen gaat u naar Mensgericht ontwerp voor agents.
Gebruikerservaring retourneren
Wanneer een terugkerende gebruiker de agent opent, wordt op de startpagina extra context weergegeven om ze te helpen bij het ophalen waar ze waren gebleven.
Chatkiezer
Met de chatkiezer, maar niet aanpasbaar, kunnen gebruikers eenvoudig door hun chatsessiegeschiedenis navigeren met de agent. Het wordt in de weergave voor terugkerende gebruikers weergegeven als een navigeerbare lijst met eerdere gesprekken, zodat gebruikers eerdere interacties kunnen hervatten zonder de context te hoeven herhalen.
Lijst
De lijst kan echter niet worden aangepast, is een optioneel onderdeel dat recente of relevante items uit het domein van de agent rechtstreeks op de startpagina weergeeft. Het biedt snelle toegang tot eerdere uitvoer, bijgehouden items of gecureerde inhoud zonder een nieuwe prompt.
Startpagina
Voor agents die verder gaan dan één chatinvoer, kunt u de startpagina uitbreiden met navigatie- en lijstweergaven. Deze onderdelen maken het gemakkelijker om functies te ontdekken en meer vertrouwde interacties mogelijk te maken, vergelijkbaar met een dashboard.
Navigation
Met navigatie kunnen agents meerdere weergaven of modi op één startpagina presenteren. Een agent kan bijvoorbeeld een tabblad Start en een tabblad Inzichten aanbieden, zodat gebruikers kunnen schakelen tussen een gespreksinterface en een overzichtsweergave van gegevens.
Gebruik navigatie wanneer uw agent duidelijk verschillende oppervlakken heeft die profiteren van permanente toegang op het hoogste niveau.
Verwante inhoud
- Validatierichtlijnen voor agents. Sla inzendingsvereisten voor agentnamen, prompts, responsen voor adaptieve kaarten en meer op.
- Basisbeginselen van teams-apps ontwerpen. Richtlijnen voor indeling, pictogrammen, typografie, kleur en vorm voor Teams en Copilot-apps.