命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示Microsoft Entra代理注册表中 AI 代理的特定已部署实例。 代理实例与用于定义其功能、技能和元数据的 agentCardManifest 相关联。 代理实例可以组织到集合中，并通过 agentRegistry 进行管理。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | agentInstance 集合 | 获取 agentInstance 对象及其属性的列表。 |
| 创建 | agentInstance | 创建新的 agentInstance 对象。 |
| Get | 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"
}
]
}