Tipo de recurso agentCollection

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una colección de instancias de agente en agentRegistry. Las colecciones de agentes proporcionan una manera de organizar y agrupar instancias de agente relacionadas con fines de administración y organización.

Las colecciones de agentes permiten la agrupación de instancias de agente con fines organizativos y de control de acceso. Las colecciones especiales son Global y Quarantined.

Colecciones reservadas

Dos colecciones reservadas por el sistema siempre están disponibles por inquilino:

Colección	Id.	Objetivo
Global	00000000-0000-0000-0000-000000000001	Grupo para todo el inquilino de agentes disponibles con carácter general
Cuarentena	00000000-0000-0000-0000-000000000002	Área de retención para agentes bloqueados o pendientes de revisión

Comportamientos clave:

1. Siempre presente: UN GET por identificador reservado nunca devuelve 404 (sintético devuelto si no se conserva).
2. Inmutabilidad: no se puede actualizar ni eliminar una colección reservada; de lo contrario, se devuelve un 403 Forbidden código de error con el mensaje "collectionImmutable".
3. Protecciones de creación: al intentar crear una colección cuya displayName coincide con una reservada, se devuelve 409 Conflict código de error.

Hereda de la entidad.

Methods

Método	Tipo devuelto	Descripción
List	colección agentCollection	Obtenga una lista de los objetos agentCollection y sus propiedades.
Crear	agentCollection	Cree un nuevo objeto agentCollection.
Get	agentCollection	Lea las propiedades y relaciones del objeto agentCollection .
Actualizar	Ninguno	Actualice las propiedades de un objeto agentCollection.
Lista de miembros de agentCollection	Colección agentInstance	Lista de objetos agentInstance de la colección.
Agregar a la colección	agentInstance	Agregue una agentInstance a agentCollection.
Quitar de la colección	Ninguno	Quite un objeto agentInstance de agentCollection.

Propiedades

Propiedad	Tipo	Descripción
createdBy	String	Id. de objeto del usuario o la aplicación que creó la instancia del agente.
createdDateTime	DateTimeOffset	Marca de tiempo cuando se creó la colección de agentes.
description	Cadena	Descripción/propósito de la colección.
displayName	Cadena	Nombre descriptivo de la colección.
id	Cadena	Identificador único para la colección. Clave. Heredado de la entidad.
lastModifiedDateTime	DateTimeOffset	Marca de tiempo de la última actualización.
managedBy	Cadena	appId (denominado identificador de aplicación (cliente) en el Centro de administración Microsoft Entra) de la entidad de servicio que administra este agente.
originatingStore	Cadena	Sistema o almacén de origen donde se originó la colección. Por ejemplo, Copilot Studio.
ownerIds	Colección string	Lista de identificadores de objeto para los propietarios de la instancia del agente.

Relaciones

Relación	Tipo	Descripción
members	Colección agentInstance	Lista de instancias de agente que son miembros de esta colección. Admite $expand.

Representación JSON

La siguiente representación JSON muestra el 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)"
}