需完成外部接口注册、认证与链路配置,具体路径包括:一、Agent内置HTTP节点直连;二、MuleRun后台配置全局API凭证;三、通过n8n桥接复杂API;四、对接MuleSoft Anypoint企业网关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在 MuleRun 平台上让 AI Agent 主动调用外部系统 API(如飞书群消息推送、ERP 数据查询、支付网关确认等),则需完成外部接口的注册、认证与链路配置。以下是实现该目标的具体操作路径:
一、通过 Agent 内置 HTTP 节点直接调用
此方式适用于无需长期复用、一次性或低频调用的外部接口,利用 MuleRun 自带的 Chainlit + vLLM 推理环境中的 HTTP 请求能力,在 nanobot 工作流中嵌入请求逻辑。
1、进入目标 Agent 的编辑模式,点击画布空白处添加“HTTP Request”节点。
2、在节点属性面板中填写目标 API 的完整 URL,例如 https://open.feishu.cn/open-apis/bot/v2/hook/xxx。
3、选择请求方法(GET/POST),并在 Headers 区域手动添加认证字段,如 Authorization: Bearer your_token 或 Content-Type: application/json。
4、若为 POST 请求,在 Body 区域以 JSON 格式输入有效载荷,支持使用 {{input}} 占位符动态注入上游节点输出。
5、连接该 HTTP 节点至后续处理节点(如日志记录、条件判断),保存并发布 Agent 版本。
二、在 MuleRun 后台配置全局 API Credential
此方式适用于多个 Agent 共享同一套第三方服务凭据(如企业微信 Bot Key、Stripe Secret Key),通过平台级凭证管理避免硬编码,提升安全性与可维护性。
1、登录 https://mulerun.com 后,点击右上角头像,进入 Settings → API Credentials 页面。
2、点击“Add Credential”,选择类型为 Custom HTTP API。
3、填写凭证名称(如 feishu-bot-prod)、基础 URL(https://open.feishu.cn/open-apis)、认证方式(Bearer Token / API Key / Basic Auth)及对应值。
4、启用“Auto-inject into HTTP nodes”选项,使所有新建 HTTP 节点默认继承该认证配置。
5、保存后,在任意 Agent 编辑器中拖入 HTTP 节点时,其 Headers 将自动填充已配凭证,仅需补全路径(如 /bot/v2/hook/xxx)即可。
三、通过 n8n 工作流桥接外部 API
当目标 API 需要复杂编排(如重试机制、OAuth2 三步授权、多端口轮询)或原生不支持 JSON-RPC/RESTful 规范时,可将 n8n 作为中间调度层部署于 MuleRun 外部,并通过 Webhook 方式接入。
1、在自有服务器或 Vercel 上部署 n8n 实例,确保其公网可访问且具备 HTTPS。
2、在 n8n 中创建新工作流,添加 Webhook 触发节点,复制其生成的唯一 URL(如 https://your-n8n.vercel.app/webhook/mulerun-feishu)。
3、在 MuleRun Agent 画布中添加“Webhook Call”节点,粘贴上述 URL 作为目标地址。
4、在 n8n 工作流后续节点中配置真实 API 调用(如 HTTP Request + OAuth2 Node + Error Trigger),并设置返回格式为 JSON。
5、测试触发:在 MuleRun 中运行 Agent,观察 n8n 日志是否收到请求并成功转发至下游 API。
四、使用 MuleSoft Anypoint 作为企业级 API 网关对接
适用于已部署 MuleSoft Anypoint Platform 的企业用户,将 MuleRun Agent 视为下游消费方,通过标准化 API 管理策略统一管控鉴权、限流、审计与协议转换。
1、在 Anypoint Exchange 中发布目标业务 API,确保其已启用 API Manager 并配置好 SLA 策略。
2、获取该 API 的生产环境 URL 及客户端 ID/密钥对(Client ID + Client Secret)。
3、在 MuleRun 的 API Credentials 页面新增凭证,类型选 MuleSoft OAuth2,填入 Token URL(如 https://anypoint.mulesoft.com/accounts/api/v2/oauth2/token)、Client ID 与 Client Secret。
4、在 Agent 的 HTTP 节点中设置 Base URL 为 Anypoint 暴露的 API 地址(如 https://api.yourcompany.com/v1/inventory),启用自动令牌刷新。
5、验证响应头中是否包含 X-MULE-TRACE-ID 字段,确认调用已纳入 Anypoint 运行时监控体系。

















