Basisaanpassingen voor agents

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.

Overzicht van de startpagina van de agent met de titelbalk, het pictogram, de naam, de bronvermelding, het chatinvoervak, starters voor prompts, de weergave voor terugkerende gebruikers met de chatkiezer en -lijst, en de startpagina met de navigatie- en geschiedenisfunctie.

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 name waarde in manifest.json, het JSON-bestand van de declaratieve agent en name_for_human in 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.

Scherm met de ontwerpindeling van navigatie in de Microsoft Copilot ervaring.

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.