用途：用于创建或审查明确要求的、基于容器的 Foundry 托管智能体，使用 Azure AI Projects SDK 中的 HostedAgentDefinition。它是 hosted-agents-v2-py 的兼容别名，新引用建议改用后者；仅含指令性流程，不捆绑可执行支持文件，可离线使用。
主要能力：通过 client.agents.create_version 创建托管智能体版本，支持指定协议版本（AgentEndpointProtocol.RESPONSES，version "2.0.0"）、容器镜像、CPU/内存分配和环境变量；可列出与删除智能体版本。
安装与配置：pip install 'azure-ai-projects==2.3.0' azure-identity；设置 AZURE_AI_PROJECT_ENDPOINT 环境变量。前置条件包括：镜像已构建并推送至 Azure Container Registry（ACR）、为项目身份授予注册表拉取权限（当前指引使用 Container Registry Repository Reader）、确认项目/区域托管智能体可用性及网络策略、确保 SDK 版本为 2.3.0。认证使用 DefaultAzureCredential 等 Azure 凭据流程。
限制：创建智能体、授予角色和删除版本均属云端写操作，须在用户授权范围内进行；创建版本不代表容器运行健康，需轮询 get_version 状态并设截止时间；工具字典仅描述应用意图，不应假定 HostedAgentDefinition 存在 tools 字段；环境变量不构成 Key Vault 集成，密钥需平台受保护注入机制；资源规格为示意值，需先验证区域/SKU 限制；文档检查不等于云集成测试。缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。