Udostępnij przez

Metadane agenta i wzorce odnajdywania

Metadane agenta służą jako podstawa odnajdywania agentów w rejestrze Microsoft Entra Agent. Podane metadane określają, w jaki sposób inni agenci, aplikacje i użytkownicy mogą znajdować agenta i korzystać z niego. Zrozumienie schematu metadanych i jego relacji z modelem kolekcji gwarantuje, że agenci będą odnajdywalni przez zamierzonych odbiorców przy zachowaniu odpowiednich granic zabezpieczeń.

Schemat metadanych agenta

Schemat metadanych agenta definiuje strukturę informacji wymaganą do odnajdywania i interakcji agenta. Ten schemat umożliwia współpracę agentów za pośrednictwem standardowych protokołów, rozszerzając je przy użyciu funkcji specyficznych dla firmy Microsoft w celu zapewnienia zwiększonych zabezpieczeń.

Podstawowe informacje o agencie

Podstawowe metadane obejmują podstawowe informacje identyfikacyjne i kontaktowe agenta.

(No changes needed) Description
id Unikatowy identyfikator manifestu agenta. Wymagane dla wszystkich rejestracji agentów.
displayName Identyfikator czytelny dla człowieka wyświetlany w wynikach wyszukiwania. Należy wyraźnie wskazać cel agenta, taki jak "Asystent obsługi klienta" lub "Agent przetwarzania faktur".
description Szczegółowe informacje na temat przeznaczenia i możliwości agenta. Uwzględnij odpowiednie słowa kluczowe, których docelowi odbiorcy będą naturalnie używać podczas wyszukiwania tego typu agenta, bezpośrednio wpływając na możliwość odnajdywania.
iconUrl Adres URL obrazu ikony agenta zapewniającego identyfikację wizualną w wynikach wyszukiwania i interfejsach użytkownika.
version Wersja implementacji agenta, umożliwiająca śledzenie aktualizacji agenta oraz uwzględnienie kwestii zgodności w scenariuszach integracji.
documentationUrl Adres URL dokumentacji agenta. Dołącz linki do szczegółowej dokumentacji interfejsu API, przykładów użycia i przewodników rozwiązywania problemów w celu obsługi pomyślnego wdrożenia agenta.
protocolVersion Wersja protokołu obsługiwana przez agenta, zapewniając zgodność z klientami i innymi agentami podczas komunikacji.
provider Informacje o organizacji dostarczającej agenta, w tym nazwę organizacji i adres URL kontaktu. Pomaga zidentyfikować źródło agentów podczas odnajdywania i zapewnia punkty weryfikacji dla autentyczności agenta.
managedBy Identyfikator aplikacji zarządzający tym manifestem, jasno określając własność i odpowiedzialność za cykl życia i konfigurację agenta.
originatingStore Nazwa magazynu lub systemu, z którego pochodzi agent, pomagając śledzić źródła agentów i pochodzenie w rejestrze.

Metadane umiejętności i możliwości

Podstawowe funkcje i możliwości interakcji zapewniane przez agenta.

(No changes needed) Description
skills Podstawowe funkcje zapewniane przez agenta. Każda umiejętność wymaga unikatowego identyfikatora, nazwy opisowej i szczegółowego opisu, który wyjaśnia, jakie umiejętności osiąga. Bezpośrednio określa możliwość odnajdywania w wyszukiwaniach opartych na możliwościach.
defaultInputModes Domyślne tryby wprowadzania obsługiwane przez agenta. Używaj spójnych specyfikacji typów MIME, takich jak "text/plain", "application/json" lub "image/png", aby zapewnić odpowiednie dopasowanie do aplikacji klienckich.
defaultOutputModes Tryby danych wyjściowych domyślnie obsługiwane przez agenta. Określ formaty danych generowane przez agenta, umożliwiając automatyczne sprawdzanie zgodności podczas odnajdywania agentów.
capabilities Funkcje techniczne obsługiwane przez agenta na potrzeby protokołów integracji.
capabilities.extensions Możliwości rozszerzenia zawierające właściwości, w tym identyfikator URI, opis, wymagany status i parametry. Wpływa na sposób interakcji innych agentów i aplikacji z agentem podczas scenariuszy federacyjnych.

Informacje o bezpieczeństwie i dostawcy

Wymagania dotyczące zabezpieczeń i uwierzytelniania wpływające na odnajdywanie, zaufanie i zasady dostępu. Informacje o zabezpieczeniach i dostawcach mają bezpośredni wpływ na sposób, w jaki Rejestr agenta Microsoft Entra stosuje zasady przypisywania i odkrywania kolekcji do Twojego agenta, dzięki czemu te pola mają kluczowe znaczenie dla odpowiedniego zarządzania i zgodności.

(No changes needed) Description
securitySchemes Słownik definicji schematów zabezpieczeń indeksowany według nazw schematów, obejmujący metody uwierzytelniania obsługiwane przez agenta. Gwarantuje, że agent pojawi się w wynikach wyszukiwania tylko dla klientów, którzy mogą spełnić wymagania dotyczące uwierzytelniania.
security Tablica odwołań do schematów zabezpieczeń stosowanych w różnych operacjach. Definiuje wymagania dotyczące zabezpieczeń, które uniemożliwiają nieudane próby integracji i ulepszają środowisko użytkownika przez filtrowanie niezgodnych dopasowań podczas odnajdywania.
signatures Podpisy cyfrowe manifestu, które obejmują chronioną zawartość, wartości podpisu oraz informacje nagłówka, służą do weryfikacji integralności i autentyczności manifestu.
supportsAuthenticatedExtendedCard Wskazuje, czy agent udostępnia więcej metadanych dla uwierzytelnionych rozmówców. Umożliwia stopniowe ujawnianie informacji, gdzie podstawowe możliwości są publicznie wykrywane, podczas gdy szczegółowe informacje operacyjne wymagają uwierzytelniania.
ownerIds Lista identyfikatorów właścicieli, którzy mają władzę nad manifestem agenta.

Kolekcje i możliwość odnajdywania

Kolekcje określają, którzy agenci mogą się nawzajem odnaleźć i ustanowić kanały komunikacyjne. Agenci muszą być jawnie przypisani do kolekcji przez administratorów lub zgodnie z określonymi politykami organizacyjnymi. Nie ma przypisań automatycznych opartych na tagach metadanych ani cechach agenta. Ten precyzyjny model przypisania zapewnia prawidłowy nadzór nad zarządzaniem i bezpieczeństwem nad widocznością agentów i schematami interakcji.

Aby uzyskać kompleksowe informacje o typach kolekcji, regułach przypisywania i zasadach odnajdywania, zobacz Kolekcje rejestru agentów.

Treści powiązane

  • Last updated on