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.
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 | String collection | 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"
}
]
}