如何在Azure AI Foundry中为Agent添加OpenAPI端点作为“action”？

问题说明 #

Azure官方文档有调用OpenAPI端点的示例，目前Azure AI Foundry的Agents处于预览阶段。添加Action时默认选中的是「代码解释器」，这个类型需要上传本地文件，我推测要上传示例里的swagger.json，但不清楚需要什么模板代码才能让Agent调用该API。另外我碰到的问题和MS问答中关于启用自定义函数与OpenAPI 3.0规范的问题一致。

解决步骤 #

• 切换Action类型：别用默认的「代码解释器」，手动选自定义函数/OpenAPI规范类型的Action——代码解释器是用来处理本地文件的，不适合OpenAPI调用场景。
• 上传规范文件：直接上传符合OpenAPI 3.0规范的swagger.json，平台会自动解析文件里的API定义，生成可调用的函数。
• 无需额外模板代码：只要Swagger文件规范没问题，Agents会自动生成API调用逻辑，不用自己写模板代码。如果识别失败，检查Swagger文件：
  • 确认openapi字段是3.0.x版本
  • 所有API的operationId唯一且清晰
  • 正确配置请求参数、响应格式以及认证方式（如果有）
• 测试验证：在Agent测试面板输入触发API调用的指令，比如「调用XX接口获取数据」，观察Agent是否自动调用对应函数，失败的话查看平台错误日志（大多是Swagger解析错误或权限配置问题）。

内容的提问来源于stack exchange，提问作者Eddy Pronk