命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
重要
即将更改代理注册表 API
从 2026 年 5 月开始，Microsoft Graph 中的代理注册表 API 将替换为由 Microsoft Agent 365 提供支持的代理注册表 API。 此更改整合了代理管理体验，以便更轻松地观察、治理和保护租户中的所有代理。 建议计划在发布基于Agent 365的新 API 时迁移到这些 API。 详细了解代理注册表与 Microsoft Agent 365 的融合。
表示Microsoft Entra代理注册表中 AI 代理的特定已部署实例。 代理实例与用于定义其功能、技能和元数据的 agentCardManifest 相关联。 代理实例可以组织到集合中，并通过 agentRegistry 进行管理。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | agentInstance 集合 | 获取 agentInstance 对象及其属性的列表。 |
| 创建 | agentInstance | 创建新的 agentInstance 对象。 |
| 获取 | agentInstance | 读取 agentInstance 对象的属性和关系。 |
| 更新 | agentInstance | 更新 agentInstance 对象的属性。 |
| 删除 | 无 | 删除 agentInstance 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| additionalInterfaces | agentInterface 集合 | 代理支持的其他接口/传输。 |
| agentIdentityBlueprintId | String | agentIdentityBlueprint 对象的对象 ID。 |
| agentIdentityId | String | agentIdentity 对象的对象 ID。 |
| agentUserId | String | 与代理关联的 agentUser 的对象 ID。 此为只读属性。 |
| createdBy | String | 创建代理实例的用户或应用程序的对象 ID。 只读。 |
| createdDateTime | DateTimeOffset | 创建代理实例时的时间戳。 只读。 |
| displayName | String | 代理实例的显示名称。 |
| id | String | 代理实例的唯一标识符。 键。 继承自 entity。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改的时间戳。 |
| managedBy | String | appId (在管理此代理的应用程序Microsoft Entra 管理中心) 上称为应用程序 (客户端) ID。 |
| originatingStore | String | 代理源自的存储/系统的名称。 例如 Copilot Studio。 |
| ownerIds | 字符串集合 | 代理实例所有者的对象 ID 列表。 |
| preferredTransport | String | 首选传输协议。 可取值为：JSONRPC、GRPC 和 HTTP+JSON。 |
| 签名 | agentCardSignature 集合 | 代理实例的数字签名。 |
| sourceAgentId | String | 原始源系统中代理的标识符。 |
| url | String | 代理实例的终结点 URL。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| agentCardManifest | agentCardManifest | 代理卡代理实例的清单。 |
| 集合 | agentCollection 集合 | 代理实例所属的代理集合。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.agentInstance",
"id": "String (identifier)",
"ownerIds": [
"String"
],
"managedBy": "String",
"originatingStore": "String",
"createdBy": "String",
"displayName": "String",
"sourceAgentId": "String",
"agentIdentityBlueprintId": "String",
"agentIdentityId": "String",
"agentUserId": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"url": "String",
"preferredTransport": "String",
"additionalInterfaces": [
{
"@odata.type": "microsoft.graph.agentInterface"
}
],
"signatures": [
{
"@odata.type": "microsoft.graph.agentCardSignature"
}
]
}