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.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Importante
Alteração futura às APIs do Registo de Agentes
A partir de maio de 2026, as APIs de Registo de Agentes no Microsoft Graph serão substituídas pelas APIs do Registo de Agentes com tecnologia Microsoft Agent 365. Esta alteração consolida as experiências de gestão de agentes para facilitar a observação, governação e segurança de todos os agentes no seu inquilino. Recomendamos que planeie migrar para as novas APIs baseadas em Agent 365 quando forem lançadas. Saiba mais sobre a convergência do Registo de Agentes com Microsoft Agent 365.
Representa uma instância implementada específica de um agente de IA no Microsoft Entra Agent Registry. Uma instância de agente está associada a um agentCardManifest que define as suas capacidades, competências e metadados. As instâncias de agente podem ser organizadas em coleções e geridas através do agentRegistry.
Herda de entidade.
Methods
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | agentInstance collection | Obtenha uma lista dos objetos agentInstance e respetivas propriedades. |
| Create | agentInstance | Crie um novo objeto agentInstance. |
| Get | agentInstance | Leia as propriedades e relações do objeto agentInstance . |
| Atualizar | agentInstance | Atualize as propriedades de um objeto agentInstance. |
| Delete | Nenhum | Eliminar um objeto agentInstance. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| additionalInterfaces | agentInterface collection | Interfaces/transportes adicionais suportados pelo agente. |
| agentIdentityBlueprintId | Cadeia de caracteres | ID de objeto do objeto agentIdentityBlueprint . |
| agentIdentityId | Cadeia de caracteres | ID de objeto do objeto agentIdentity . |
| agentUserId | Cadeia de caracteres | ID do objeto do agentUser associado ao agente. Somente leitura. |
| createdBy | Cadeia de caracteres | ID do objeto do utilizador ou da aplicação que criou a instância do agente. Somente leitura. |
| createdDateTime | DateTimeOffset | Carimbo de data/hora quando a instância do agente foi criada. Somente leitura. |
| displayName | Cadeia de caracteres | Nome a apresentar para a instância do agente. |
| id | Cadeia de caracteres | Identificador exclusivo da instância do agente. Chave. Herdado da entidade. |
| lastModifiedDateTime | DateTimeOffset | Carimbo de data/hora da última modificação. |
| managedBy | Cadeia de caracteres | appId (conhecido como ID da Aplicação (cliente) na centro de administração do Microsoft Entra) da aplicação que gere este agente. |
| originatingStore | Cadeia de caracteres | Nome do arquivo/sistema de origem do agente. Por exemplo, Copilot Studio. |
| ownerIds | Coleção String | Lista de IDs de objeto para os proprietários da instância do agente. |
| preferredTransport | Cadeia de caracteres | Protocolo de transporte preferencial. Os valores possíveis são JSONRPC, GRPC e HTTP+JSON. |
| assinaturas | coleção agentCardSignature | Assinaturas digitais para a instância do agente. |
| sourceAgentId | Cadeia de caracteres | Identificador do agente no sistema de origem original. |
| url | Cadeia de caracteres | URL de ponto final para a instância do agente. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| agentCardManifest | agentCardManifest | O agente card manifesto da instância do agente. |
| coleções | coleção agentCollection | As coleções de agentes das quais a instância do agente é membro. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.agentInstance",
"id": "String (identifier)",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"displayName": "String",
"sourceAgentId": "String",
"agentIdentityBlueprintId": "String",
"agentIdentityId": "String",
"agentUserId": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"url": "String",
"preferredTransport": "String",
"additionalInterfaces": [
{
"@odata.type": "microsoft.graph.agentInterface"
}
],
"signatures": [
{
"@odata.type": "microsoft.graph.agentCardSignature"
}
]
}