tipo de recurso agentInstance

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

Próxima mudança nas APIs do Agent Registry

A partir de maio de 2026, as APIs de Registro de Agente no Microsoft Graph serão substituídas pelas APIs de Registro de Agente da plataforma Microsoft Agent 365. Essa alteração consolida as experiências de gerenciamento de agentes para facilitar a observação, o controle e a segurança de todos os agentes em seu locatário. Recomendamos que você planeje migrar para as novas APIs baseadas no Agent 365 quando elas forem lançadas. Saiba mais sobre a convergência do Registro de Agente com o Microsoft Agent 365.

Representa uma instância específica implantada de um agente de IA no Registro do Microsoft Entra Agent. Uma instância de agente é associada a um agentCardManifest que define suas funcionalidades, habilidades e metadados. As instâncias do agente podem ser organizadas em coleções e são gerenciadas por meio do agentRegistry.

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
List	Coleção AgentInstance	Obtenha uma lista dos objetos agentInstance e suas propriedades.
Create	agentInstance	Crie um novo objeto agentInstance.
Get	agentInstance	Leia as propriedades e relacionamentos do objeto agentInstance .
Atualizar	agentInstance	Atualize as propriedades de um objeto agentInstance.
Delete	Nenhum	Exclua um objeto agentInstance.

Propriedades

Propriedade	Tipo	Descrição
additionalInterfaces	Coleção AgentInterface	Interfaces/transportes adicionais suportados pelo agente.
agentIdentityBlueprintId	Cadeia de caracteres	ID do objeto agentIdentityBlueprint .
agentIdentityId	Cadeia de caracteres	ID 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 usuário ou aplicativo que criou a instância do agente. Somente leitura.
createdDateTime	DateTimeOffset	Carimbo de data/hora em que a instância do agente foi criada. Somente leitura.
displayName	Cadeia de caracteres	Nome de exibição da instância do agente.
id	Cadeia de caracteres	Identificador exclusivo para a 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 do aplicativo (cliente) no centro de administração do Microsoft Entra) do aplicativo que gerencia esse agente.
originatingStore	Cadeia de caracteres	Nome do repositório/sistema em que o agente se originou. 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 do ponto de extremidade para a instância do agente.

Relações

Relação	Tipo	Descrição
agentCardManifest	agentCardManifest	O manifesto do card do agente da instância do agente.
de 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 a seguir 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"
    }
  ]
}