Skip to content

配置外部调用

🔐 安全声明

为了保护你的机器人安全,星辰RPA 采用严格的权限管理机制。只有经过显式授权的机器人才能被外部系统调用。未授权的机器人无法通过外部接口访问。

概述

配置外部调用权限需要下面两步:

  1. 设计器发版 - 将机器人项目发布为外部可调用的版本
  2. 外部配置 - 在设计器中配置该机器人允许哪些外部系统调用

本文档将详细介绍这两个步骤的完整流程。

前提条件

  • 已在星辰RPA设计器中创建并测试了你的机器人
  • 已生成 API KEY(详见 API KEY 管理

第一步:设计器中发版

1.1 发布版本

点击设计器顶部工具栏中的 发布 按钮(或设计器列表页的发版按钮),将当前机器人发布为可外部调用的版本。

发布按钮位置

第二步:配置外部调用权限

2.1 进入执行器列表

发版完成后,在执行器列表中找到该机器人,点击 ... 选项,找到外部配置调用。

进入项目设置

2.2 填写机器人配置信息

在权限配置表单中,填写以下信息并点击确定保存:

字段说明
是否启用外部调用开启此开关,允许该机器人被外部系统调用
机器人名称机器人的内部名称,用于系统识别
机器人英文名机器人的显示名称,主要用于MCP调用
机器人简介对此机器人功能的简要说明
机器人参数机器人的输入参数列表,显示参数名、类型等信息

填写权限信息

现在,具有有效 API KEY 的外部系统就可以调用此机器人了。

验证外部调用

完成权限配置后,你可以通过以下方式验证外部调用是否正常:

使用 OpenAPI 调用

bash
curl -X GET "https://newapi.iflyrpa.com/api/rpa-openapi/workflows/get?pageNo=1&pageSize=10" \
  -H "Authorization: Bearer {YOUR_API_KEY}"

执行工作流

bash
curl -X POST "https://newapi.iflyrpa.com/api/rpa-openapi/workflows/execute" \
  -H "Authorization: Bearer {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "your_workflow_id",
    "params": {}
  }'

详见 异步运行工作流同步运行工作流

常见问题

Q: 如果我忘记发版会怎样?

A: 如果机器人未发版,即使配置了外部调用权限,外部系统也无法调用。请确保先完成 第一步:设计器中发版

Q: 权限配置多久生效?

A: 权限配置保存后立即生效,无需重启设计器或机器人服务。

Q: 如何监控外部调用?

A: 在设计器的 执行日志 中,你可以查看所有外部调用的执行记录和结果。每条记录都会显示执行时间、执行结果等信息。

相关文档