tipo de recurso agentCollection

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 coleção de instâncias de agente no agentRegistry. As coleções de agentes fornecem uma forma de organizar e agrupar instâncias de agente relacionadas com gestão e fins organizacionais.

As coleções de agentes permitem o agrupamento de instâncias de agente para fins organizacionais e de controlo de acesso. As coleções especiais são Global e Quarantined.

Coleções Reservadas

Estão sempre disponíveis duas coleções reservadas pelo sistema por inquilino:

Coleção	ID	Objetivo
Global	00000000-0000-0000-0000-000000000001	Conjunto ao nível do inquilino de agentes geralmente disponíveis
Em quarentena	00000000-0000-0000-0000-000000000002	Área de retenção para agentes bloqueados/pendentes de revisão

Principais comportamentos:

1. Sempre presente: um GET por ID reservado nunca devolve 404 (sintético devolvido se não persistir).
2. Imutabilidade: não pode ATUALIZAR ou ELIMINAR uma coleção reservada; caso contrário, é devolvido um 403 Forbidden código de erro com a mensagem "collectionImmutable".
3. Proteções de criação: tentar criar uma nova coleção cujo displayName corresponde a um reservado devolve 409 Conflict o código de erro.

Herda de entidade.

Methods

Método	Tipo de retorno	Descrição
List	coleção agentCollection	Obtenha uma lista dos objetos agentCollection e respetivas propriedades.
Create	agentCollection	Crie um novo objeto agentCollection.
Get	agentCollection	Leia as propriedades e relações do objeto agentCollection .
Atualizar	Nenhum(a)	Atualize as propriedades de um objeto agentCollection.
Listar membros de agentCollection	agentInstance collection	Lista de objetos agentInstance na coleção.
Adicionar à coleção	agentInstance	Adicione um agentInstance ao agentCollection.
Remover da coleção	Nenhum	Remova um objeto agentInstance do agentCollection.

Propriedades

Propriedade	Tipo	Descrição
createdBy	Cadeia de caracteres	ID do objeto do utilizador ou da aplicação que criou a instância do agente.
createdDateTime	DateTimeOffset	Carimbo de data/hora quando a coleção de agentes foi criada.
description	Cadeia de caracteres	Descrição/objetivo da coleção.
displayName	Cadeia de caracteres	Nome amigável da coleção.
id	Cadeia de caracteres	Identificador exclusivo para a coleção. Chave. Herdado da entidade.
lastModifiedDateTime	DateTimeOffset	Carimbo de data/hora da última atualização.
managedBy	Cadeia de caracteres	appId (referido como ID da Aplicação (cliente) na centro de administração do Microsoft Entra) do principal de serviço que gere este agente.
originatingStore	Cadeia de caracteres	Sistema/arquivo de origem onde a coleção teve origem. Por exemplo, Copilot Studio.
ownerIds	String collection	Lista de IDs de objeto para os proprietários da instância do agente.

Relações

Relação	Tipo	Descrição
membros	agentInstance collection	Lista de instâncias de agente que são membros desta coleção. Suporta o $expand.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "@odata.type": "#microsoft.graph.agentCollection",
  "id": "String (identifier)",
  "ownerIds": [
    "String"
  ],
  "managedBy": "String",
  "originatingStore": "String",
  "createdBy": "String",
  "displayName": "String",
  "description": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)"
}