Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La pagina iniziale dell'agente è la schermata principale di accesso. È il punto in cui gli utenti iniziano a interagire in un ambiente circoscritto. In genere fornisce il nome, l'icona e l'attribuzione dell'agente e può includere altri elementi in base al suo scopo, ad esempio interazioni passate, dashboard o raccolte multimediali, per fornire contesto e accesso rapido alle funzionalità pertinenti.
Ottenere questi elementi fondamentali è essenziale. Stabiliscono l'identità, impostano le aspettative e segnalano l'attendibilità prima dell'invio del primo messaggio.
La home page dell'agente è costituita da diversi elementi distinti. Ogni elemento svolge un ruolo specifico per aiutare gli utenti a comprendere e interagire con l'agente.
| Elemento | Description |
|---|---|
| Barra del titolo | Visualizza le informazioni di base dell'agente, la navigazione e le opzioni di base. |
| Icona | Elemento di personalizzazione dell'agente, consentendo un riconoscimento più semplice da parte degli utenti. |
| Nome | Identificatore univoco o titolo dell'agente, consentendo agli utenti di riconoscerne lo scopo o la funzione. |
| Attribution | Visualizza i mezzi o l'organizzazione dietro l'agente, consentendo agli utenti di verificarne l'autenticità e l'affidabilità. |
| Casella di input della chat | Il mezzo principale per consentire agli utenti di interagire con l'agente, consentendo loro di immettere query o comandi. La casella di input della chat segue le stesse linee guida del Microsoft 365 Chat nativo, garantendo un'esperienza coerente. |
| Suggerimenti per prompt | Brevi suggerimenti selezionabili visualizzati nella schermata iniziale dell'agente prima che un utente digita qualcosa. Guidano gli utenti su come iniziare e su cosa può fare l'agente. |
Icona
L'icona è il primo segnale visivo associato all'agente. Dovrebbe essere chiaro, intenzionale e coerente con il tuo marchio.
Per la progettazione dell'icona dell'agente, seguire queste linee guida:
- Usa un'immagine semplice e riconoscibile che riflette lo scopo dell'agente.
- Verificare che l'icona funzioni con dimensioni ridotte. Viene visualizzato in superfici dell'interfaccia utente compatta come la barra del titolo, la selezione chat e l'archivio agenti.
- Evitare il testo nell'icona. I nomi vengono identificati separatamente.
- Seguire le linee guida per le icone dell'app Teams per i requisiti di dimensioni, forma e colore.
Note
Le icone fanno parte del pacchetto dell'app. Assicurarsi che le risorse delle icone soddisfino i requisiti dello Store di Teams prima di pubblicarle. Per altre informazioni, vedere linee guida per la convalida per gli agenti.
Name
Il nome è l'identificatore univoco visualizzato dagli utenti nell'intera esperienza dell'agente, nella barra del titolo, nella selezione agente, nella cronologia delle chat e nell'archivio agenti. Deve comunicare immediatamente lo scopo dell'agente.
Segui queste linee guida quando assegni un nome all'agente:
- Usare un nome chiaro e conciso che rifletta la funzione o il dominio dell'agente. Ad esempio: Contoso Ticket Manager o Sales Pipeline Agent.
- Evitare attestazioni superlaative come "migliore", "incredibile" o "#1".
- Evitare nomi eccessivamente generici che non differenziano l'agente da altri.
- Per gli agenti dichiarativi, il
namevalore inmanifest.json, il file JSON dell'agente dichiarativo ename_for_humanin qualsiasi file JSON del plug-in deve essere identico. - Non usare frasi imperative, URL, emoji o caratteri nascosti nel nome.
Important
Il nome dell'agente nell'interfaccia utente deve corrispondere esattamente al nome definito nel manifesto. Le incoerenze possono causare errori di convalida durante la pubblicazione nello Store.
Attribuzione
L'attribuzione mostra l'editore o l'organizzazione responsabile dell'agente. Viene visualizzato nella home page dell'agente e consente agli utenti di verificare l'origine dell'agente prima di interagire con esso.
L'attribuzione chiara supporta l'attendibilità dell'utente. Gli utenti che possono identificare chi ha sviluppato un agente e ritenere responsabile tale soggetto hanno maggiori probabilità di interagire con maggiore fiducia. Questo trust è particolarmente importante negli ambienti aziendali in cui gli agenti possono gestire flussi di lavoro o dati sensibili.
Assicurarsi che l'attribuzione rifletta il nome effettivo dell'organizzazione registrato nel Centro per i partner. Evita un'attribuzione ingannevole che faccia pensare a un agente sviluppato da Microsoft o proprietario, se l'agente è pubblicato in modo indipendente.
Suggerimenti per prompt
Gli starter prompt sono brevi suggerimenti selezionabili visualizzati nella schermata iniziale dell'agente. Guidano gli utenti verso interazioni significative prima di digitare qualsiasi elemento.
Suggerimenti per prompt effettivi:
- Rispecchia casi d'uso reali. Ogni comando iniziale dovrebbe corrispondere a un compito che l'agente può effettivamente completare.
- Usa linguaggio semplice e orientato alle azioni. Condurre con un verbo o una domanda chiara. Evitare il gergo.
- Illustra una gamma di funzionalità dell'agente. Non raggruppare tutti gli starter intorno a una funzionalità.
- Tienili brevi. Ogni inizio del prompt non deve superare i 128 caratteri.
Esperienza utente di prima esecuzione
Quando un utente accede al tuo agente per la prima volta, la home page visualizza l'icona, il nome, l'attribuzione e i prompt iniziali dell'agente. Nessuna cronologia conversazioni è presente. Questo è il momento di fare una forte impressione.
L'esperienza al primo avvio deve:
- Stabilire immediatamente l'identità e lo scopo. Gli utenti devono sapere cosa fa l'agente entro pochi secondi dall'arrivo.
- Abbassare la barriera per iniziare. Gli starter prompt rimuovono il problema di richiesta vuota fornendo agli utenti punti di ingresso concreti e attendibili.
- Impostare aspettative accurate. Il nome, l'attribuzione e i prompt iniziali dovrebbero nel loro insieme comunicare ciò che l'agente può e non può fare.
Per altre indicazioni sulla progettazione di esperienze di prima esecuzione, vedere Progettazione centrata sull'uomo per gli agenti.
Restituzione dell'esperienza utente
Quando un utente di ritorno apre l'agente, la home page mostra informazioni contestuali aggiuntive per aiutarlo a riprendere da dove aveva lasciato.
Selezione chat
La selezione chat, anche se non personalizzabile, consente agli utenti di spostarsi facilmente nella cronologia delle sessioni di chat con l'agente. Viene visualizzato nella visualizzazione utente restituita come elenco esplorabile delle conversazioni precedenti, consentendo agli utenti di riprendere le interazioni precedenti senza ripetere il contesto.
Elenco
L'elenco, anche se non personalizzabile, è un componente facoltativo che presenta elementi recenti o rilevanti dal dominio dell'agente direttamente nella home page. Consente di accedere rapidamente agli output precedenti, agli elementi rilevati o al contenuto curato senza richiedere una nuova richiesta.
Pagina iniziale
Per gli agenti che non si limitano a un singolo input di chat, è possibile estendere la home page con viste di navigazione e di elenco. Questi componenti semplificano l'individuazione e l'abilitazione di interazioni più avanzate, più familiari, simili a un dashboard.
Navigation
La navigazione consente agli agenti di presentare più visualizzazioni o modalità all'interno di una singola home page. Ad esempio, un agente potrebbe offrire una scheda Home e una scheda Informazioni dettagliate , in modo che gli utenti possano passare da un'interfaccia di conversazione a una visualizzazione di riepilogo dei dati.
Usa la navigazione quando il tuo agente presenta superfici chiaramente distinte che beneficiano di un accesso persistente di primo livello.
Contenuti correlati
- Linee guida per la convalida per gli agenti. Requisiti per la pubblicazione nello Store relativi al nome dell'agente, ai prompt, alle risposte delle Adaptive Card e altro ancora.
- Nozioni fondamentali sulla progettazione delle app di Teams. Layout, icone, tipografia, colori e linee guida per le forme delle app di Teams e Copilot.