Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os metadados do agente servem como base para a descoberta de agente no Registro do Agente do Microsoft Entra. Os metadados fornecidos determinam como outros agentes, aplicativos e usuários podem encontrar e interagir com seu agente. Entender o esquema de metadados e sua relação com o modelo de coleções garante que seus agentes sejam detectáveis pelo público-alvo pretendido, mantendo os limites de segurança apropriados.
Esquema de metadados do agente
O esquema de metadados do agente define a estrutura de informações necessária para a descoberta e interação do agente. Esse esquema permite a colaboração do agente por meio de protocolos padrão, estendendo-o com recursos específicos do Microsoft Entra para segurança aprimorada.
Informações básicas do agente
Os metadados fundamentais incluem informações essenciais de identificação e contato para seu agente.
| Campo | Description |
|---|---|
id |
Identificador exclusivo para o manifesto do agente. Necessário para todos os registros de agente. |
displayName |
Identificador legível por humanos que aparece nos resultados da descoberta. Deve indicar claramente a finalidade do agente, como "Assistente de Suporte ao Cliente" ou "Agente de Processamento de Fatura". |
description |
Detalhes abrangentes sobre a finalidade e as funcionalidades do agente. Inclua palavras-chave relevantes que seu público-alvo usaria naturalmente ao pesquisar esse tipo de agente, afetando diretamente a capacidade de descoberta. |
iconUrl |
URL para a imagem de ícone do agente, fornecendo identificação visual em resultados de descoberta e interfaces do usuário. |
version |
Versão da implementação do agente, habilitando 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 uso e guias de solução de problemas para dar suporte à adoção bem-sucedida do agente. |
protocolVersion |
Versão do protocolo com suporte do agente, garantindo compatibilidade com clientes e outros agentes durante a comunicação. |
provider |
Informações sobre a organização que fornece o agente, incluindo o nome da organização e a URL de contato. Ajuda a identificar a origem dos agentes durante a descoberta e fornece pontos de verificação para autenticidade do agente. |
managedBy |
Identificador de aplicativo que gerencia esse manifesto, estabelecendo clara propriedade e responsabilidade pelo ciclo de vida e configuração do agente. |
originatingStore |
Nome do repositório ou sistema no qual o agente se originou, ajudando a rastrear fontes e linhagem do agente dentro do registro. |
Metadados de habilidades e funcionalidades
Os principais recursos de funcionalidade e interação que seu agente fornece.
| Campo | Description |
|---|---|
skills |
Funcionalidade principal que seu agente fornece. Cada habilidade requer um identificador exclusivo, um nome descritivo e uma descrição detalhada que explica o que a habilidade realiza. Determina diretamente a capacidade de descoberta em pesquisas baseadas em funcionalidade. |
defaultInputModes |
Modos de entrada padrão suportados pelo agente. Use especificações de tipo MIME consistentes, como "text/plain", "application/json" ou "image/png" para garantir a correspondência adequada com aplicativos cliente. |
defaultOutputModes |
Modos de saída padrão suportados pelo agente. Especifique os formatos de dados que seu agente produz, permitindo a verificação automática de compatibilidade durante a descoberta do agente. |
capabilities |
Recursos técnicos aos quais seu agente dá suporte para protocolos de integração. |
capabilities.extensions |
Funcionalidades de extensão que contêm propriedades, incluindo URI, descrição, status necessário e parâmetros. Afeta como outros agentes e aplicativos interagem com seu agente durante cenários de federação. |
Informações de segurança e provedor
Requisitos de segurança e autenticação que afetam a capacidade de descoberta, a confiança e as políticas de acesso. Informações de segurança e provedor afetam diretamente como o Registro do Agente do Microsoft Entra aplica políticas de atribuição de coleção e descoberta ao seu agente, tornando esses campos essenciais para o gerenciamento e a conformidade adequados.
| Campo | Description |
|---|---|
securitySchemes |
Dicionário de definições dos esquemas de segurança organizados pelo nome do esquema, especificando os métodos de autenticação aos quais seu agente dá suporte. Garante que seu agente apareça nos resultados de descoberta apenas para clientes que podem atender aos requisitos de autenticação. |
security |
Matriz de referências de esquema de segurança que se aplicam a operações diferentes. Define os requisitos de segurança que impedem tentativas de integração com falha e melhoram a experiência do usuário filtrando 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 a autenticidade do manifesto. |
supportsAuthenticatedExtendedCard |
Indica se o agente fornece mais metadados para chamadores autenticados. Permite a divulgação progressiva de informações, em que as funcionalidades básicas são publicamente detectáveis, enquanto informações operacionais detalhadas exigem autenticação. |
ownerIds |
Lista de identificadores de proprietário que têm autoridade sobre o manifesto do agente. |
Coleções e capacidade de descoberta
As coleções determinam quais agentes podem descobrir uns aos outros e estabelecer canais de comunicação. Os agentes devem ser atribuídos explicitamente a coleções por administradores ou por meio de políticas organizacionais definidas. Não há atribuições automáticas com base em marcas de metadados ou características do agente. Esse modelo de atribuição explícita garante controles de segurança e governança adequados sobre os padrões de descoberta e interação do agente.
Para obter informações abrangentes sobre tipos de coleção, regras de atribuição e políticas de descoberta, consulte as coleções de registro do Agente.