你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure AI Foundry 代理服务 REST API 提供用于创建、配置和运行 AI 代理的终结点。 这些代理是云托管服务，可将大型语言模型 （LLM） 与工具配对，以代表您读取数据、调用函数和执行逻辑。 该服务完全由 Azure 托管，因此您可以专注于构建智能工作流，而无需管理基础设施。
该 API 遵循与 Azure OpenAI 助手 API 相同的协议。 这允许您使用现有的 OpenAI 兼容工具和 SDK，只需进行最少的配置更改。
有关该服务的更多信息，请参阅 Azure AI 代理服务文档。
REST 操作组
API作按核心概念分组。 使用左侧的目录浏览可用的终端节点。 主要运营组包括：
- 代理 – 创建、检索、更新或删除代理定义。 代理包括模型、说明和工具配置。
- Threads （线程） – 创建或列出对话线程。 线程表示交互的消息历史记录。
- Messages （消息 ） – 在线程中添加或检索消息。 消息可以来自用户或代理。
- Runs （运行） – 在线程上启动代理运行。 运行处理线程，并可能在执行期间调用工具。
- Run steps （运行步骤 ） – 检查运行期间执行的各个作，例如工具调用或模型调用。
- 工具 – 注册和管理 OpenAPI 规范定义的自定义工具。
身份验证
代理服务支持用于身份验证的 Microsoft Entra ID 令牌。 尚不支持 Azure 资源密钥。
访问由 Azure 基于角色的访问控制 （RBAC） 控制。 有关更多详细信息，请参阅 什么是 Azure 基于角色的访问控制 （Azure RBAC）？ 和 Azure AI Foundry 的基于角色的访问控制。