月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
第一次调用模型
本教程带你用 Python 完成三件事：向模型发送一个问题并拿到回答，用模型创建一个带指令的 agent，并在同一会话中完成一次多轮对话。前提是已有一个 Foundry 项目，并且项目中有一个可用的模型（已部署或即时模型）。
前置条件
项目 | 要求 | 备注 |
Foundry 资源与项目 | 已创建 Microsoft Foundry 资源和项目 | 官方“设置 Microsoft Foundry 资源”快速开始可完成此步，本页未读取其正文 |
模型部署 | 项目中已部署一个模型，示例使用名为 gpt-5-mini 的部署 | 部署名与示例不一致时，需同步修改代码中的模型名 |
即时模型（可选） | 不部署模型，直接使用即时模型试用 | 官方称目前为预览，且需在指定区域的项目中使用，区域与预览状态待核实（2026-11-05 获取） |
开发环境 | Python 运行环境、Visual Studio Code（可选）与 Azure CLI | 具体安装步骤见官方“准备开发环境”页面，本页未核实 |
账户权限 | 能在项目中调用模型与创建 agent | 具体所需角色待核实（2026-11-05 获取） |
步骤
- 获取项目端点。 按官方“获取项目连接信息”的说明找到项目端点（本页未读取该页，具体位置待核实）。格式为
https://<资源名>.services.ai.azure.com/api/projects/<项目名>。
- 安装 Python 包。 安装官方当前版本的
azure-ai-projects（2.x 系列）与azure-identity。最低版本号待核实（2026-11-05 获取）。
- 登录。 在终端运行 Azure CLI 的登录命令，让示例通过 DefaultAzureCredential 获取凭据。
- 替换占位值。 Python 示例不读取环境变量，需要在每个文件里把项目端点与 agent 名称替换为你的值，例如
MyAgent。
- 发起一次模型调用。 用项目客户端获取 OpenAI 客户端，调用 Responses API，传入模型部署名与一个问题，例如“法国的面积是多少平方英里”。
- 创建 agent。 指定模型与指令（例如“你是一个回答通用问题的助手”），创建后得到 agent 的名称与版本号。门户路径为：Build 区域 → Agents → Create agent。
- 多轮对话。 为 agent 创建一个会话，先问一个问题，再在同一会话中追问（例如“首都是哪里”）。第二个回答应能正确理解上下文。
- 清理资源。 不再需要时，在 Azure 门户删除项目所在的资源组。注意这会删除该组内的所有资源。
预期结果
步骤 | 你应该看到 |
5 | 控制台输出一段模型生成的回答；若回答为空，示例会抛出错误 |
6 | 控制台打印 agent 的名称与版本号，门户的 Agents 列表中出现该 agent |
7 | 两次回答均出现，且第二次回答能延续第一次的话题 |
常见问题
现象 | 可能原因 | 处理 |
调用时出现接口不存在或参数不匹配的错误 | 安装了 1.x 版本的包 | 卸载旧包，安装 2.x 系列；官方说明 1.x 与示例不兼容 |
认证失败或提示未登录 | 未运行登录命令，或当前账户没有项目权限 | 重新登录，并检查项目角色（待核实） |
找不到模型部署 | 示例中的模型名与你的部署名不一致 | 把代码中的模型名改为实际部署名 |
端点格式报错 | 端点写成了门户首页或资源地址 | 使用上文的项目端点格式 |
回答为空 | 模型返回了空文本，示例会主动报错 | 检查模型部署是否正常，换一个问题重试 |
按示例改用其他语言仍失败 | 不同语言的 SDK 包名与版本不同 | 以对应语言的官方示例与包版本为准 |
限制与待核实
- 本教程只覆盖 Python 路径。官方示例还提供 C#、TypeScript、Java、REST API 与门户版本，本页未逐一核对。
- 示例中的模型名称（gpt-5-mini）与 SDK 方法名随官方文档更新，以当期页面为准（2026-11-05 获取）。
- 即时模型的区域、预览状态与可用模型列表待核实（2026-11-05 获取）。
来源与核对
- 页面来源（公开 URL）：
- https://learn.microsoft.com/en-us/azure/foundry/quickstarts/get-started-code（正文已读，本教程的步骤与示例来源）
- https://learn.microsoft.com/en-us/azure/foundry/what-is-foundry（正文已读，agent 与模型的背景说明）
- read_scope：正文已读（以上两页）。前置的资源创建与开发环境准备页面未读取，相关细节标注为待核实。
- 图片：抓取结果中未找到非图标的图片地址，本页未放图。
上一篇
更新日志
下一篇
如何选择 Azure AI 服务
Loading...