代理开发生命周期

Microsoft Foundry 中的代理生成体验带来了许多开发和可观测性功能，从代理创建到将代理嵌入应用程序。 可以使用 Foundry 门户或代码来生成、自定义和测试代理的行为。 然后，可以迭代使用跟踪、评估和监视等能力，以提升代理的性能。 准备就绪后，您可以发布代理，以在应用程序中预览、共享并查看代理的实际效果。

代理类型

有三种类型的代理：

• 基于提示：基于提示的代理是声明性定义的单个代理，它结合了模型配置、指令、工具和自然语言提示来驱动行为。 可以通过附加知识和内存功能使代理更加强大。 基于提示的智能体可以在 Foundry 门户的智能体操场中进行编辑、版本控制、测试、评估、监视和发布。

• 工作流：如果要开发由一系列作组成的更高级代理工作流，或一起协调多个代理，可以使用工作流执行此作。 工作流在门户中有自己的开发界面，但相同的生命周期适用。 有关详细信息，请参阅 工作流文章。

• 托管：托管代理是通过支持的代理框架或自定义代码在代码中开发的容器化代理。 Foundry 代理服务部署和管理这些代理。 它们主要通过代码优先体验创建，无法在 Foundry 上的代理生成接口中编辑。 但是，可以像基于提示的代理和工作流一样查看、调用、评估、监视和发布它们。 有关详细信息，请参阅 有关托管代理的文章。

可以使用 CLI、SDK 或 REST API 在 Foundry 门户中或你自己的开发环境中创建基于提示的代理和工作流。 有关详细信息，请参阅快速入门。

创建基于提示的代理

如果已知道要创建的代理类型，可以对其进行命名，然后快速开始配置模型说明和工具。 如果尚未部署模型，则会为你部署一个可用的模型。

在代码中开发

如果想要在代码中工作，可通过多种方法将代理代码引入开发环境，以便从中在本地进行测试，然后部署到 Azure。

从智能体操场聊天窗格的“代码”选项卡中，你可以获取引用你的智能体的代码片段，并将其导入专用的 Visual Studio Code for the Web 云环境。 该代码片段预配置了所需的包和扩展，以及高效开发和将 Foundry 代理部署到 Azure 的说明。 还可以将代码片段直接复制到首选的开发环境。 有关详细信息，请参阅 场文档。

代理开发生命周期的核心功能

代理生成体验为代理开发生命周期的每个核心步骤提供集成体验。 建议在开发生产就绪代理应用程序时使用这些核心功能。 每个功能都有深入的文档，你可以在其中了解详细信息。

将更改另存为版本

创建基于提示的代理或工作流的第一个版本后，可以将后续更改保存为新版本。 你可以在智能体操场中测试未保存的更改。 但是，如果想要查看对话历史记录、监视代理的性能或运行完整评估，系统会提示保存更改。

代理版本控制提供以下功能来管理代理配置和迭代。 此系统可确保跨版本跟踪、可测试且可比较所有更改。

• 版本不可变性：保存代理的每个版本都是不可变的。 对现有版本所做的任何修改都需要保存和创建新版本。 此要求有助于确保版本完整性并防止意外覆盖。

• 草稿状态管理：可以测试未保存状态下的代理以进行试验。 如果离开 Foundry 门户，则丢失未保存的更改，因此请经常保存以保留重要的修改。

• 版本控制作：可以将请求定向到特定的代理版本，以启用受控部署和回滚功能。

• 版本历史记录导航：可以访问任何代理的版本历史记录，转到任何特定版本，并执行以下比较：

  • 代理设置比较：比较版本之间的配置设置。 可以使用版本下拉列表选择要比较的版本。
  • 聊天输出比较：使用相同的输入分析代理版本之间的响应差异。
  • YAML 定义比较：查看代理定义的差异。

添加工具

你可以通过授予代理知识（特定文件或索引）或允许代理执行作（调用外部 API）来使其更强大。 工具可用于大多数用例，从简单的文件上传到自定义模型上下文协议 （MCP） 服务器连接。 对于更复杂的工具，可能需要配置身份验证或添加连接作为将其附加到代理的一部分。

若要能够保存附加了工具的代理，必须成功配置该工具。 可以在代理之间重复使用已配置的工具。 有关可用工具的信息，请参阅 工具目录。

发布代理或工作流

拥有满意的代理或工作流版本后， 将其发布为代理应用程序。 然后，你有一个稳定的终结点，可以在浏览器中打开和测试、与他人共享或嵌入现有应用程序。 你和你的协作者可以验证性能，并确定需要优化的内容。 可以随时进行任何必要的更新并重新发布新版本。