用途：端到端验证 python/samples/04-hosting/foundry-hosted-agents/ 下的 Python Foundry 托管智能体示例。通过三项独立检查（本地原生 python main.py 并经 HTTP 调用、azd ai agent run 本地开发循环、azd deploy 部署到 Foundry 后调用）加清理，确认单轮与多轮（session / previous_response_id）对话均成功。开始前应先读示例自身 README.md 及上级 README.md。
必要输入：Foundry 项目 endpoint 与资源 id、项目中实际已部署的模型名、可复用的现有 ACR（login server）、项目内是否已有同名智能体。工具与认证：az（az login）、azd（azd auth login）、azd 的 azure.ai.agents 扩展（azd extension install azure.ai.agents）、uv；复用 ACR 时不需要 Docker。
主要阶段：Phase 1 原生本地验证——uv 建 3.12 虚拟环境、装 requirements.txt、由 .env.example 生成 .env（FOUNDRY_PROJECT_ENDPOINT、FOUNDRY_MODEL），运行 python main.py（端口 8088），向 /responses POST 单轮并复用 response_id 做多轮，断言 HTTP 200 与非空文本且多轮能回忆。另有可缓存复现的 playbook 脚本，仅覆盖 Phase 1，用 httpx 轮询就绪、测试两轮、finally 终止服务。Phase 2 经 azd ai agent run/invoke 本地验证；Phase 3 复用 ACR 后 azd deploy，并用 azd ai agent show/invoke 验证。
限制与注意：部署所用模型名来自 agent.yaml 而非 azd env；azd ai agent delete/show 依赖 AGENT_{SERVICEKEY}_NAME 环境变量；避免 azd provision/azd up 以免创建模型部署；python 无需在 PATH；结束后须删除已部署智能体、临时 azd 项目、示例目录内 .env/.venv，并释放端口 8088。