rrbdagent"

# RRBD Admin项目智能助手 本技能提供与RRBD Admin项目后端API交互和自动化操作的功能，支持通过自然语言对话来执行各种操作，特别是数字人形象管理相关功能。 ## 项目结构 ``` rrbdagent/ ├── rrbd-admin-aishijie/ # 前端参考代码（不归属技能包） └── skills/ └── rrbdagent/ ├── SKILL.md # 技能文档 ├── config.json # 配置文件 └── scripts/ # Python脚本目录 ├── api_client.py # API客户端 ├── test_login.py # 登录测试脚本 ├── test_virtualman.py # 数字人形象测试脚本 └── config.json # 配置文件 ``` ## 核心功能 ### 多轮对话能力 - **智能会话管理**：支持多轮对话，当用户请求需要登录的操作时，自动引导用户输入账号密码 - **上下文保持**：保持对话上下文，支持分步收集信息 - **智能意图识别**：能够识别自然语言表达的意图 ### 数字人形象管理 - **形象列表查询**：查询用户的数字人形象列表 - **详细信息展示**：以表格形式展示数字人形象的详细信息 - **状态过滤**：支持按状态筛选数字人形象 ### 视频创建 - **智能视频生成**：根据用户提供的文案创建视频 - **智能创作**：使用智能创作模式，自动选择模板 - **模板选择**：随机获取一个模板用于视频创建 - **自动选择资源**：默认选择第一个数字人形象和声音 - **异步状态检查**：自动检查视频创建状态，等待1-3分钟完成 - **视频URL获取**：完成后自动获取视频URL地址 - **参数配置**：支持设置视频比例、时长等参数 ### API集成 - **真实API调用**：直接调用后端真实API，非模拟数据 - **认证管理**：自动处理登录和token管理 - **错误处理**：友好的错误提示和异常处理 ### 自动化脚本 - **Python脚本**：使用Python脚本执行自动化操作 - **配置管理**：通过JSON配置文件管理API设置 - **测试工具**：提供测试脚本验证功能 ## 自然语言交互能力 ### 支持的自然语言指令 #### 用户管理 - "登录系统" - "获取我的用户信息" - "更新我的昵称为测试用户" - "查看我的子账号列表" - "创建一个新的子账号" #### 数字人管理 - "查询我的数字人形象列表" - "用rrbdagent帮我去查询下我的账号里面的形象有哪些？" - "查看我有哪些数字人形象" #### 视频管理 - "创建一个新的视频组" - "上传视频到视频库" - "查看我的视频列表" - "删除指定的视频" - "下载视频" - "创建一个视频，文案是：今天天气真好" - "用默认形象和声音创建视频，内容是：欢迎使用AI视频生成" - "帮我生成一个视频，文案是：这是一个测试视频" #### AI服务 - "获取AI模型列表" - "创建一个AI作品" - "使用AI生成文案" #### 任务管理 - "创建一个新任务" - "查看任务列表" - "更新任务状态" #### 财务操作 - "查看我的钱包余额" - "申请提现" - "查看佣金记录" ## 技术实现 ### 自然语言处理流程 1. **意图识别**：分析用户输入，识别用户意图 2. **参数提取**：从用户输入中提取相关参数 3. **会话管理**：处理多轮对话，收集必要信息 4. **API映射**：将意图映射到相应的API端点 5. **请求构建**：构建API请求参数和头部 6. **执行调用**：发送API请求并处理响应 7. **结果反馈**：将API响应转化为自然语言反馈给用户 ### API配置 #### 基础设置 - **基础URL**：`https://rrbd20.yzidea.net/api` - **认证方式**：使用 `Authorization` 头部携带token - **租户ID**：使用 `X-Tenant-ID` 头部，默认值为 `3` - **请求超时**：120秒 #### 核心API端点 - `/user/login/pc` - 用户登录 - `/user/user/userInfo` - 获取用户信息 - `/digital/virtualMan/page` - 获取数字人形象列表 - `/digital/voice/page` - 获取声音列表 - `/digital/template/page` - 获取模板列表 - `/digital/video/videoCreate` - 创建视频 - `/digital/video/detail` - 获取视频状态 ## 配置文件 项目使用 `skills/rrbdagent/config.json` 配置文件管理基础设置： ```json { "api": { "base_url": "https://rrbd20.yzidea.net/api", "tenant_id": "3" }, "login": { "default_username": "", "default_password": "" }, "endpoints": { "login": "/user/login/pc", "user_info": "/user/user/userInfo", "virtual_man_list": "/digital/virtualMan/page", "voice_list": "/digital/voice/page", "video_create": "/digital/video/videoCreate", "video_normal_create": "/digital/video/normalVideoCreate" } } ``` **注意：** 首次使用时，系统会提示用户输入手机号和密码，并自动保存到配置文件中。 ## 自动化脚本 ### Python脚本 - **api_client.py**：API客户端，处理登录和API调用 - **test_login.py**：测试登录功能 - **test_virtualman.py**：测试数字人形象列表查询 - **test_video_create.py**：测试视频创建功能 ### 使用方法 1. **测试登录**：`python skills\rrbdagent\scripts\test_login.py` 2. **查询数字人形象**：`python skills\rrbdagent\scripts\test_virtualman.py` 3. **测试视频创建**：`python skills\rrbdagent\scripts\test_video_create.py` ## 使用示例 ### 自然语言交互示例 #### 数字人形象查询 ``` 用户：用rrbdagent帮我去查询下我的账号里面的形象有哪些？ 助手：请提供您的账号（手机号） 用户：18098901246 助手：请提供您的密码 用户：123456 助手：登录成功！ 助手：您的数字人形象列表： - 姐姐3333 - 唐总数字人 - 李总办公室 - 李红AI0529 - 李红数字人123 - 黎总数字人2 - 李红数字人 - 王姐沙发 - 王姐数字人 - 王姐数字人 - 端姐漂亮版 - 端姐数字人222 - 张姐说一物一码 - 张姐数字人 - 张总视频 - 张总 - 鸡蛋项目 - 老曾情感故事2 - 老曾情感故事 - 老曾讲故事 - 测试 - 老曾极速版 ``` #### 登录操作 ``` 用户：登录系统，账号是18098901246，密码是123456 助手：正在执行登录操作... 助手：登录成功！您已成功登录系统。 ``` #### 获取用户信息 ``` 用户：获取我的用户信息 助手：正在获取您的用户信息... 助手：您的用户信息如下： - 用户名：18098901246 - 昵称：测试用户 - ID：1881009417432883202 ``` #### 创建视频 ``` 用户：创建一个视频，文案是：今天天气真好 助手：请提供您的账号（手机号） 用户：18098901246 助手：请提供您的密码 用户：123456 助手：登录成功！ 助手：正在获取数字人形象列表... 助手：默认选择数字人：姐姐3333 助手：正在获取声音列表... 助手：默认选择声音：默认女声 助手：正在创建视频... 助手：视频创建成功！ 助手：视频ID：123456789 助手：视频标题：AI生成视频 ``` ## 触发条件 当以下情况时调用此技能： - 用户使用自然语言询问如何执行系统操作 - 用户要求执行具体的API调用 - 用户需要自动化完成一系列操作 - 用户询问系统状态或数据 - 用户需要故障排除或技术支持 - 用户询问数字人形象相关信息 ## 依赖项 - **后端**：带有JWT认证的RESTful API - **自然语言处理**：意图识别和实体提取 - **Python**：requests 库 - **环境**：Python >= 3.6 ## 安全考虑 - 所有API请求包含适当的认证头部 - Token管理遵循安全实践 - 通过X-Tenant-ID头部维护租户隔离 - 敏感操作需要适当的授权 - 用户输入验证，防止恶意请求 - 错误信息脱敏，保护系统信息 ## 扩展能力 - **自定义指令**：支持用户定义常用操作的快捷指令 - **批量操作**：支持一次性执行多个相关操作 - **定时任务**：支持设置定时执行的任务 - **多语言支持**：支持中文和英文自然语言输入 - **个性化配置**：根据用户偏好调整响应方式 - **脚本扩展**：通过Python脚本扩展功能 ## 集成方式 - **自动化脚本**：作为自动化脚本的一部分使用 - **Python脚本**：通过Python脚本执行自动化操作