rpa-caller

# 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 | --- ## 注意事项 1. **安全**：不要在对话中明文显示完整的密码或高权限 Token 2. **幂等性**：每次请求使用唯一 task_id（建议用时间戳）避免重复执行 3. **异步任务**：大多数 RPA 任务是异步的，提交后需要轮询状态接口 4. **错误重试**：网络错误可以重试，但业务逻辑错误需要修正参数后再试 5. **日志**：建议用户在 RPA 系统侧开启日志，便于排查问题 --- ## 参考文件 - `references/rpa-api-map.xlsx` — RPA 功能清单，包含所有接口定义和参数说明 - 如需新增功能，按 Excel 模版格式填写后告知 Claude 重新加载