创建 prompt agent

前置条件

• 一个 Foundry 项目，并且项目中已部署一个可用的模型（官方示例使用 gpt-5-mini，具体可用模型以项目为准）。

• 项目已连接 Application Insights，且你有权限读取追踪数据。

• 已安装 Python，并能运行 pip 与 az 命令。

• 对项目具有 Foundry User 角色（创建与调用智能体所需）。

步骤

1. 在 Foundry 门户的欢迎页复制项目端点，格式为 https://<资源名>.services.ai.azure.com/api/projects/<项目名>。

2. 安装依赖：azure-ai-projects（官方示例要求 2.3.0 或更高版本）与 azure-identity。

3. 运行 az login，让 DefaultAzureCredential 使用当前登录身份。

4. 在脚本中填入端点、智能体名称（例如 MyAgent）和模型部署名。

5. 调用 create_version 创建智能体版本，definition 中设置模型与指令（instructions）。

6. 创建会话（conversation），发送第一条问题，再在同一会话中发送追问，验证第二轮能延续上下文。

7. 结束后删除会话，并删除本次创建的智能体版本，避免版本堆积。

参数

预期结果

• 控制台输出智能体的 id、名称与版本号。

• 第一轮回答针对首个问题。

• 第二轮追问（“那首都是哪里？”这类依赖上一轮的问题）能得到基于上下文的回答。

• 门户的追踪页面能看到对应的调用记录（需 Application Insights 已连接）。

常见问题

清理资源

• 删除本次创建的会话与智能体版本。

• 如果是为本教程专门创建的资源组，可在 Azure 门户删除资源组；删除会移除组内的全部资源，操作前需确认。

限制与待核实

• 官方页面的更新日期为 2026-11-04，示例代码以该日期为准。

• 其他语言（C#、TypeScript、Java）、REST 与门户路径的步骤未在本教程展开。

• 示例模型名、SDK 版本号与配额：待核实（2026-11-05 获取）。

来源与核对

• 来源：Quickstart: Create a prompt agent（https://learn.microsoft.com/en-us/azure/foundry/agents/quickstarts/prompt-agent）

• 来源：What is Microsoft Foundry Agent Service?（https://learn.microsoft.com/en-us/azure/foundry/agents/overview）

• 核对范围：正文已读（快速入门正文已读，Python 路径已核对；其他语言未核对）。