命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示 agentRegistry 中代理实例的集合。 代理集合提供了一种用于组织和分组相关代理实例的方法，以便进行管理和组织。
代理集合允许出于组织和访问控制目的对代理实例进行分组。 特殊集合是 Global 和 Quarantined。
保留集合
每个租户始终提供两个系统保留集合：
| 集合 | ID | 用途 |
|---|---|---|
| 全球 | 00000000-0000-0000-0000-000000000001 |
租户范围的正式版代理池 |
| 隔离 | 00000000-0000-0000-0000-000000000002 |
已阻止/正在审批的代理的保留区域 |
关键行为：
- 始终存在：如果未保留) ，则 GET by 保留 ID 从不返回 404 (合成返回。
- 不可变性：不能更新或删除保留集合，否则将
403 Forbidden返回带有消息“collectionImmutable”的错误代码。 - 创建保护：尝试创建一个新集合，其 displayName 与保留的集合匹配，将
409 Conflict返回错误代码。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | agentCollection 集合 | 获取 agentCollection 对象及其属性的列表。 |
| 创建 | agentCollection | 创建新的 agentCollection 对象。 |
| Get | agentCollection | 读取 agentCollection 对象的属性和关系。 |
| 更新 | 无 | 更新 agentCollection 对象的属性。 |
| 列出 agentCollection 的成员 | agentInstance 集合 | 集合中的 agentInstance 对象列表。 |
| 添加到集合 | agentInstance | 将 agentInstance 添加到 agentCollection。 |
| 从集合中删除 | 无 | 从 agentCollection 中删除 agentInstance 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| createdBy | String | 创建代理实例的用户或应用的对象 ID。 |
| createdDateTime | DateTimeOffset | 创建代理集合时的时间戳。 |
| description | String | 集合的说明/用途。 |
| displayName | String | 集合的友好名称。 |
| id | String | 集合的唯一标识符。 键。 继承自 entity。 |
| lastModifiedDateTime | DateTimeOffset | 上次更新的时间戳。 |
| managedBy | String | appId (在管理此代理的服务主体Microsoft Entra 管理中心) 上称为应用程序 (客户端) ID。 |
| originatingStore | String | 集合的来源源系统/存储。 例如 Copilot Studio。 |
| ownerIds | 字符串集合 | 代理实例所有者的对象 ID 列表。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 成员 | agentInstance 集合 | 属于此集合的成员的代理实例列表。 支持 $expand。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@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)"
}