RPA HTTP 调用 Skill

本 Skill 让 Claude 能够通过 HTTP 请求调用 RPA 系统，完成各类自动化任务。 RPA 功能清单和对应 API 定义在 references/rpa-api-map.xlsx 中，使用前必须先读取。

核心工作流程

Step 1：理解用户意图

明确用户想让 RPA 完成什么任务，例如：

"帮我自动填写报销单"
"批量下载这些文件"
"打开系统并录入数据"

Step 2：查找对应 RPA 功能

从 Excel 功能清单（references/rpa-api-map.xlsx）中查找：

匹配用户意图的功能名称
对应的 HTTP Method 和 Endpoint
必填参数 / 可选参数
预期返回结果

如果找不到匹配功能，告知用户并列出所有可用功能供其选择。

Step 3：收集必填参数

根据功能清单，向用户确认所有必填参数。例如：

目标文件路径
要填写的数据内容
时间范围
目标系统账号（如需要）

对于敏感参数（密码、token），提示用户注意安全，避免明文存储。

Step 4：构建 HTTP 请求

Method: [GET / POST / PUT / DELETE]
URL: {BASE_URL}{endpoint}
Headers:
  Content-Type: application/json
  Authorization: Bearer {API_KEY}   ← 如功能清单中有鉴权要求
Body (JSON):
{
  "task_id": "唯一任务ID（可用时间戳）",
  "params": {
    // 根据功能清单填入具体参数
  }
}

Step 5：展示请求并确认

在执行前，以结构化方式展示完整的请求内容，请用户确认后再发送。

示例展示格式：

📋 即将调用 RPA 功能：【批量下载文件】

接口：POST http://localhost:8088/api/rpa/download-files
参数：
  - source_dir: /data/reports/2024/
  - file_pattern: *.pdf
  - dest_dir: /output/

是否确认执行？

Step 6：发起请求并处理响应

发起请求后，根据响应状态给出反馈：

| 响应状态 | 处理方式 | |---------|---------| | 200 / 任务提交成功 | 告知任务ID，提示如何查询状态 | | 202 Accepted | 异步任务已接受，等待执行 | | 400 参数错误 | 列出错误字段，引导用户修正 | | 401 / 403 鉴权失败 | 提示检查 API_KEY 或权限 | | 404 接口不存在 | 检查 BASE_URL 和 endpoint 是否正确 | | 500 服务端错误 | 建议检查 RPA 服务是否正常运行 | | 超时 / 无响应 | 建议检查 RPA 服务的连接状态 |

Step 7：任务状态追踪（如支持）

如果功能清单中有状态查询接口，主动提示用户可以查询执行进度：

任务已提交！Task ID: rpa_20240315_143022
可以告诉我「查询任务状态」来追踪执行进度 🤖

全局配置（首次使用时设置）

使用本 Skill 前，需要确认以下配置信息：

BASE_URL:  http://your-rpa-server:8088   ← RPA 服务地址
API_KEY:   your-api-key-here             ← 鉴权 Token（如有）

如果用户没有提供，主动询问这两个值，并在对话中记住它们。

常用功能速查

以下为示例，实际功能以 Excel 功能清单为准

| 用户说 | 对应功能 | |--------|---------| | 帮我填表 / 录入数据 | data-entry | | 下载文件 / 批量下载 | file-download | | 截图 / 截取屏幕 | screenshot | | 打开网页 / 访问系统 | open-browser | | 查询任务进度 | task-status | | 停止任务 | task-stop |

注意事项

安全：不要在对话中明文显示完整的密码或高权限 Token
幂等性：每次请求使用唯一 task_id（建议用时间戳）避免重复执行
异步任务：大多数 RPA 任务是异步的，提交后需要轮询状态接口
错误重试：网络错误可以重试，但业务逻辑错误需要修正参数后再试
日志：建议用户在 RPA 系统侧开启日志，便于排查问题

参考文件

references/rpa-api-map.xlsx — RPA 功能清单，包含所有接口定义和参数说明
如需新增功能，按 Excel 模版格式填写后告知 Claude 重新加载