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.

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

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

Coleções reservadas

Duas coleções reservadas pelo sistema estão sempre disponíveis por locatário:

Coleção ID Objetivo
Global 00000000-0000-0000-0000-000000000001 Pool de agentes geralmente disponíveis em todo o locatário
Em quarentena 00000000-0000-0000-0000-000000000002 Área de espera para agentes bloqueados/com revisão pendente

Principais comportamentos:

  1. Sempre presente: um GET por ID reservada nunca retorna 404 (sintético retornado se não persistir).
  2. Imutabilidade: Você não pode ATUALIZAR ou EXCLUIR uma coleção reservada, caso contrário, um código de 403 Forbidden erro com a mensagem "collectionImmutable" será retornado.
  3. Proteções de criação: A tentativa de criar uma nova coleção cujo displayName corresponda a um reservado retorna 409 Conflict um 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 suas propriedades.
Create agentCollection Crie um novo objeto agentCollection.
Get agentCollection Leia as propriedades e relacionamentos do objeto agentCollection .
Atualizar Nenhum(a) Atualize as propriedades de um objeto agentCollection.
Listar membros de agentCollection Coleção AgentInstance 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 usuário ou aplicativo que criou a instância do agente.
createdDateTime DateTimeOffset Carimbo de data/hora em que a coleção de agentes foi criada.
description Cadeia de caracteres Descrição / finalidade da coleta.
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 (conhecido como ID do aplicativo (cliente) no centro de administração do Microsoft Entra) da entidade de serviço que gerencia esse agente.
originatingStore Cadeia de caracteres Sistema de origem/repositório de origem no qual a coleção se originou. 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 Coleção AgentInstance Lista de instâncias do agente que são membros desta coleção. Suporta o $expand.

Representação JSON

A representação JSON a seguir 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)"
}
  • Última atualização em