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

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 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)"
}
  • Last updated on