Partilhar via

Metadados do agente e padrões de descoberta

Os metadados dos agentes servem como base para a descoberta de agentes dentro do Microsoft Entra Agent Registry. Os metadados que fornece determinam como outros agentes, aplicações e utilizadores podem encontrar e interagir com o seu agente. Compreender o esquema de metadados e a sua relação com o modelo de coleções garante que os seus agentes sejam descobertos pelo público-alvo, mantendo os limites de segurança adequados.

Esquema de metadados do agente

O esquema de metadados do agente define a estrutura de informação necessária para a descoberta e interação do agente. Este esquema permite a colaboração entre agentes através de protocolos padrão, estendendo-a com capacidades específicas do Microsoft Entra para maior segurança.

Informação básica do agente

Os metadados fundamentais incluem informações essenciais de identificação e contacto do seu agente.

Campo Description
id Identificador único para o manifesto do agente. Obrigatório para todos os registos de agentes.
displayName Identificador legível por humanos que aparece nos resultados da descoberta. Deve indicar claramente o objetivo do agente, como "Assistente de Apoio ao Cliente" ou "Agente de Processamento de Faturas".
description Detalhes abrangentes sobre o propósito e as capacidades do agente. Inclua palavras-chave relevantes que o seu público-alvo usaria naturalmente ao procurar este tipo de agente, impactando diretamente a descoberta.
iconUrl URL para a imagem do ícone do agente, fornecendo identificação visual nos resultados de pesquisa e nas interfaces de usuário.
version Versão da implementação do agente, permitindo o acompanhamento de atualizações do agente e considerações de compatibilidade para cenários de integração.
documentationUrl URL para a documentação do agente. Inclua links para documentação detalhada da API, exemplos de utilização e guias de resolução de problemas para apoiar a adoção bem-sucedida de agentes.
protocolVersion Versão do protocolo suportada pelo agente, garantindo compatibilidade com clientes e outros agentes durante a comunicação.
provider Informação sobre a organização que fornece o agente, incluindo nome da organização e URL de contacto. Ajuda a identificar a origem dos agentes durante a descoberta e fornece pontos de verificação para a autenticidade do agente.
managedBy O identificador de aplicação que gere este manifesto, estabelece clareza na propriedade e responsabilidade pelo ciclo de vida e configuração do agente.
originatingStore Nome da loja ou sistema onde o agente se originou, ajudando a acompanhar as origens e a linhagem do agente dentro do registo.

Metadados de competências e capacidades

A funcionalidade principal e as capacidades de interação que o seu agente oferece.

Campo Description
skills Funcionalidades essenciais que o seu agente fornece. Cada competência requer um identificador único, um nome descritivo e uma descrição detalhada que explique o que a competência realiza. Determina diretamente a encontrabilidade em pesquisas por capacidades.
defaultInputModes Modos de entrada padrão suportados pelo agente. Use especificações MIME consistentes como "texto/simples", "aplicação/json" ou "image/png" para garantir a correspondência correta com as aplicações clientes.
defaultOutputModes Modos de saída padrão suportados pelo agente. Especifique os formatos de dados que o seu agente produz, permitindo a verificação automática de compatibilidade durante a descoberta do agente.
capabilities Funcionalidades técnicas que o seu agente suporta para protocolos de integração.
capabilities.extensions Capacidades de extensão contendo propriedades como URI, descrição, estado necessário e parâmetros. Afeta como outros agentes e aplicações interagem com o seu agente durante cenários de federação.

Segurança e informações do prestador

Requisitos de segurança e autenticação que afetam a descoberta, confiança e políticas de acesso. A segurança e a informação do fornecedor afetam diretamente a forma como o Microsoft Entra Agent Registry aplica políticas de atribuição de cobrança e descoberta ao seu agente, tornando estes campos críticos para uma gestão e conformidade adequadas.

Campo Description
securitySchemes Dicionário de definições de esquemas de segurança indexados pelo nome do esquema, especificando os métodos de autenticação suportados pelo seu agente. Garante que o seu agente aparece nos resultados de descoberta apenas para clientes que cumpram os requisitos de autenticação.
security Conjunto de referências a esquemas de segurança que se aplicam a diferentes operações. Define requisitos de segurança que impedem tentativas falhadas de integração e melhoram a experiência do utilizador ao filtrar correspondências incompatíveis durante a descoberta.
signatures Assinaturas digitais para o manifesto, incluindo conteúdo protegido, valores de assinatura e informações de cabeçalho para verificar a integridade e autenticidade do manifesto.
supportsAuthenticatedExtendedCard Indica se o seu agente fornece mais metadados para chamadas autenticadas. Permite a divulgação progressiva da informação, onde as capacidades básicas são publicamente descobertas enquanto a informação operacional detalhada requer autenticação.
ownerIds Lista de identificadores de proprietários que têm autoridade sobre o manifesto do agente.

Coleções e descobribilidade

As coleções determinam que agentes podem encontrar-se mutuamente e estabelecer canais de comunicação. Os agentes devem ser explicitamente atribuídos a coleções pelos administradores ou através de políticas organizacionais definidas. Não existem atribuições automáticas baseadas em etiquetas de metadados ou características do agente. Este modelo explícito de atribuição assegura governação adequada e controlos de segurança sobre a descoberta e os padrões de interação dos agentes.

Para informações abrangentes sobre tipos de coleções, regras de atribuição e políticas de descoberta, consulte Coleções do registo de agentes.

Conteúdo relacionado

  • Last updated on