SuperAPI AI 工具集

hosted-agents-v2-py

智能体与模型

查看项目

更新于 10-16 09:34

技能介绍

用途:本技能用于在 Azure AI Foundry 中创建或审查基于容器的托管智能体(Hosted Agent),核心是使用 Azure AI Projects SDK 的 HostedAgentDefinition。安装依赖:pip install 'azure-ai-projects==2.3.0' azure-identity。需设置环境变量 AZURE_AI_PROJECT_ENDPOINT,例如 https://<resource>.services.ai.azure.com/api/projects/<project>。

前提条件:将容器镜像构建并推送至 Azure Container Registry(ACR);为项目身份授予注册表拉取权限(当前指引使用 Container Registry Repository Reader);确认项目/区域对托管智能体的可用性及应用网络策略,不要自动启用公开托管;确保 SDK 版本为 2.3.0。

主要能力:通过 AIProjectClient 使用 DefaultAzureCredential 认证,调用 client.agents.create_version 创建版本,定义 HostedAgentDefinition。参数包括:protocol_versions(必填,list[ProtocolVersionRecord],如 AgentEndpointProtocol.RESPONSES 配合 version="2.0.0")、container_configuration(镜像部署必填,ContainerConfiguration(image=...))、cpu(可选,如 "1"、"2")、memory(可选,如 "2Gi"、"4Gi")、environment_variables(可选字典)。还可用 client.agents.list_versions 列出各版本,用 client.agents.delete_version 删除指定版本。示例资源范围(CPU 0.5–4,内存 1Gi–8Gi)为示意,须先核验区域/SKU 限制。

工具配置:工具需在所选容器运行时或框架内配置,文档中的 tools 字典仅表达应用意图,不应假定 HostedAgentDefinition 存在 tools 字段或定义即可授权。

限制与注意:创建智能体、授予角色和删除版本均属云端写操作,只能在用户授权范围内执行。创建版本不等于容器运行健康,需轮询版本状态并记录观察到的健康情况。不要将删除无关版本作为例行清理。输出不能替代针对具体环境的验证、测试或专家评审。资料未提供收费与价格信息。