Dostosowania podstawowego agenta

Strona główna agenta to główny widok docelowy agenta. Jest to miejsce, w którym użytkownicy rozpoczynają interakcję w środowisku o określonym zakresie. Zazwyczaj udostępnia nazwę, ikonę i przypisanie agenta oraz może zawierać inne elementy w oparciu o jego przeznaczenie — takie jak wcześniejsze interakcje, pulpity nawigacyjne lub galerie multimediów — w celu zapewnienia kontekstu i szybkiego dostępu do odpowiednich funkcji.

Zapewnienie właściwego przygotowania tych podstawowych elementów jest niezbędne. Ustanawiają tożsamość, określają oczekiwania i sygnalizują zaufanie przed wysłaniem pierwszej wiadomości.

Strona główna agenta składa się z kilku odrębnych elementów. Każdy element odgrywa określoną rolę, pomagając użytkownikom zrozumieć agenta i wchodzić z nim w interakcję.

Ikona

Ikona jest pierwszym sygnałem wizualnym, który użytkownicy kojarzą z agentem. Powinna być jasna, celowa i spójna z twoją marką.

Postępuj zgodnie z tymi wytycznymi podczas projektowania ikony agenta:

• Użyj prostego, rozpoznawalnego obrazu odzwierciedlającego cel agenta.
• Upewnij się, że ikona działa w małych rozmiarach. Pojawia się w kompaktowych elementach interfejsu użytkownika, takich jak pasek tytułu, wybór czatu i sklep z agentami.
• Unikaj tekstu na ikonie. Nazwy są identyfikowane oddzielnie.
• Postępuj zgodnie z wytycznymi dotyczącymi ikon aplikacji Teams dotyczącymi rozmiaru, kształtu i koloru.

Nazwa

Nazwa to unikatowy identyfikator, który użytkownicy widzą w całym interfejsie agenta — na pasku tytułu, w wyborze agenta, historii czatu i sklepie agentów. Powinno od razu jasno komunikować cel agenta.

Postępuj zgodnie z poniższymi wytycznymi podczas nazywania agenta:

• Użyj jasnej, zwięzłej nazwy, która odzwierciedla funkcję lub domenę agenta. Na przykład: Contoso Ticket Manager lub Sales Pipeline Agent.
• Unikaj superlatywów, takich jak „najlepszy”, „niesamowity” czy „nr 1”.
• Unikaj nadmiernie ogólnych nazw, które nie odróżniają agenta od innych.
• W przypadku agentów deklaratywnych wartość name w manifest.json, pliku JSON agenta deklaratywnego, oraz name_for_human we wszelkich plikach JSON wtyczek muszą być identyczne.
• Nie używaj fraz instruktażowych, adresów URL, emoji ani ukrytych znaków w nazwie.

Uznanie autorstwa

Informacja o autorstwie wyświetla wydawcę lub organizację odpowiadających za agenta. Jest ona wyświetlana na stronie głównej agenta i pomaga użytkownikom zweryfikować źródło agenta przed nawiązaniem z nim kontaktu.

Jasne wskazanie autorstwa buduje zaufanie użytkowników. Użytkownicy, którzy mogą zidentyfikować, kto stworzył agenta — i pociągnąć ten podmiot do odpowiedzialności — chętniej wchodzą z nim w interakcję. To zaufanie jest szczególnie ważne w środowiskach przedsiębiorstwa, w których agenci mogą obsługiwać poufne przepływy pracy lub dane.

Upewnij się, że przypisanie odzwierciedla rzeczywistą nazwę organizacji zarejestrowaną w Centrum partnerskim. Unikaj mylącego sugerowania, że agent został utworzony przez Microsoft lub jest agentem własnym Microsoft, jeśli został opublikowany niezależnie.

Elementy rozpoczynające polecenia

Elementy rozpoczynające polecenia to krótkie, możliwe do kliknięcia sugestie wyświetlane na ekranie powitalnym agenta. Kierują użytkowników w kierunku znaczących interakcji, zanim wpiszą coś.

Skuteczne elementy rozpoczynające polecenia:

• Odzwierciedlić rzeczywiste przypadki użycia. Każdy element rozpoczynający powinien odpowiadać zadaniu, które agent może wykonać.
• Używaj zwykłego języka zorientowanego na akcje. Zacznij od czasownika lub od jasnego pytania. Unikaj żargonu.
• Omówienie zakresu możliwości agenta. Nie klastruj wszystkich początkowych elementów startowych wokół jednej funkcji.
• Niech będą krótkie. Każdy początkowy monit nie może przekraczać 128 znaków.

Doświadczenie użytkownika przy pierwszym uruchomieniu

Gdy użytkownik po raz pierwszy otwiera Twojego agenta, na stronie głównej wyświetla się ikona agenta, jego nazwa, informacja o autorze oraz propozycje promptów. Historia konwersacji nie jest obecna. Jest to moment, aby zrobić silne pierwsze wrażenie.

Proces pierwszego uruchomienia powinien:

• Natychmiast ustanów tożsamość i cel. Użytkownicy powinni wiedzieć, co robi agent w ciągu kilku sekund od przybycia.
• Obniż barierę, aby rozpocząć. Elementy rozpoczynające polecenia eliminują problem z pustym poleceniem, dając użytkownikom konkretne, zaufane punkty wejścia.
• Określ dokładne oczekiwania. Połączenie nazwy, przypisania i elementów rozpoczynających polecenia powinno wspólnie komunikować, co agent może, a czego nie może robić.

Aby uzyskać więcej wskazówek dotyczących projektowania wrażeń związanych z pierwszym uruchomieniem, przejdź do Projektowanie zorientowane na człowieka dla agentów.

Doświadczenie powracającego użytkownika

Gdy użytkownik ponownie otwiera agenta, strona główna pokazuje dodatkowe informacje kontekstowe, aby pomóc mu kontynuować od miejsca, w którym przerwał.

Selektor rozmów

Selektor czatów, choć nie dostosowywalny, umożliwia użytkownikom łatwe przechodzenie przez historię sesji czatu z agentem. Jest ona wyświetlana w widoku zwracającym użytkownika jako nawigowalnej liście poprzednich konwersacji, umożliwiając użytkownikom wznowienie wcześniejszych interakcji bez powtarzania kontekstu.

Lista

Lista, choć nie można dostosować, jest opcjonalnym składnikiem, który przedstawia ostatnie lub istotne elementy z domeny agenta bezpośrednio na stronie głównej. Zapewnia szybki dostęp do wcześniejszych danych wyjściowych, śledzonych elementów lub wyselekcjonowanej zawartości bez konieczności wyświetlania nowego monitu.

Strona główna

W przypadku agentów, którzy nie ograniczają się do pojedynczego interfejsu czatu, możesz rozszerzyć stronę główną o widoki nawigacyjne i widoki list. Te składniki ułatwiają odnajdywanie i włączanie bogatszych, bardziej znanych interakcji — podobnie jak w przypadku pulpitu nawigacyjnego.

Navigation

Nawigacja umożliwia agentom prezentowanie wielu widoków lub trybów na jednej stronie głównej. Na przykład agent może oferować kartę Narzędzia główne i kartę Szczegółowe informacje , dzięki czemu użytkownicy mogą przełączać się między interfejsem konwersacji a widokiem podsumowania danych.

Użyj nawigacji, gdy agent ma wyraźnie odrębne sekcje, które powinny być stale dostępne z poziomu nawigacji głównej.

Treści powiązane

• Wskazówki dotyczące walidacji agentów. Przechowywanie wymagań dotyczących przesyłania dla nazwy agenta, poleceń, odpowiedzi na karty adaptacyjne i nie tylko.
• Podstawy projektowania aplikacji Teams. Wskazówki dotyczące układu, ikon, typografii, koloru i kształtu dla aplikacji Teams i Copilot.