name: "rrbdagent" description: "OpenClaw skill for RRBD Admin專案。當用戶需要通過自然語言對話執行API呼叫、自動化操作或系統任務時呼叫。"

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設定
• 測試工具：提供測試指令碼驗證功能

自然語言互動能力

支援的自然語言指令

使用者管理

• "登入系統"
• "獲取我的使用者資訊"
• "更新我的暱稱為測試使用者"
• "檢視我的子賬號列表"
• "建立一個新的子賬號"

數字人管理

本技能來自小蔥技能站7w4.net。

• "查詢我的數字人形象列表"
• "用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 配置檔案管理基礎設定：

{
  "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指令碼執行自動化操作

這個 Skill 能幫使用者快速生成數字人影片，功能覆蓋較全面。但存在明顯問題：程式碼中遺留了歷史測試資料和多個重複檔案，可能導致使用混亂；部分配置與說明文件不匹配，需要仔細核對才能正常使用。整體質量中等，功能實用但細節打磨不足，適合有一定排查能力的使用者。普通使用者建議等待最佳化版本。