Ooder Agent SDK3.0.3 CLI 实战指南：从入门到精通

agent-sdk (父工程) 3.0.3
├── llm-sdk                              # LLM SDK
├── skills-framework                     # 技能框架
├── agent-sdk-core                       # 核心实现
├── agent-sdk-cli                        # CLI 工具
└── agent-sdk-spring-boot-starter        # Spring Boot Starter

# 传统方式：需要编写 Java 代码
OoderSDK sdk = OoderSDK.builder()
    .agentId("my-agent")
    .agentName("My Agent")
    .build();
WorkerAgent worker = sdk.getAgentFactory()
    .createWorkerAgent("scene-001", "worker-1", "skill-001");
worker.execute("capability-id", params);

# CLI 方式：一行命令搞定
ooder skill:install --source ./my-skill.jar
ooder skill:start --skill-id my-skill
ooder skill exec my-skill:process --input data.json

# 查看帮助
ooder --help

# 查看特定命令的用法
ooder skill:install --help

# 列出所有技能
ooder skill:list

#!/bin/bash
# 自动化部署脚本

# 安装技能
ooder skill:install --source $SKILL_URL --force

# 启动技能
ooder skill:start --skill-id $SKILL_ID

# 创建场景
ooder scene:create --group-id production --main $MAIN_CAPABILITY

# 验证状态
ooder status

<dependency>
    <groupId>net.ooder</groupId>
    <artifactId>agent-sdk-cli</artifactId>
    <version>3.0.3</version>
</dependency>

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <groupId>com.example</groupId>
    <artifactId>my-agent-app</artifactId>
    <version>1.0.0</version>
    
    <dependencies>
        <!-- Agent SDK CLI -->
        <dependency>
            <groupId>net.ooder</groupId>
            <artifactId>agent-sdk-cli</artifactId>
            <version>3.0.3</version>
        </dependency>
        
        <!-- Agent SDK Core -->
        <dependency>
            <groupId>net.ooder</groupId>
            <artifactId>agent-sdk-core</artifactId>
            <version>3.0.3</version>
        </dependency>
        
        <!-- Skills Framework -->
        <dependency>
            <groupId>net.ooder</groupId>
            <artifactId>skills-framework</artifactId>
            <version>3.0.3</version>
        </dependency>
    </dependencies>
</project>

# Ooder CLI Configuration
ooder:
  cli:
    # 安全配置
    security:
      enabled: true
      whitelist-enabled: true
      injection-check-enabled: true
      dangerous-chars-check-enabled: true
      audit-enabled: true
      
      # 命令白名单
      whitelist:
        - skill:list
        - skill:info
        - skill:install
        - skill:uninstall
        - skill:update
        - skill:start
        - skill:stop
        - skill:exec
        - scene:list
        - scene:create
        - scene:info
        - scene:invoke
        - scene:event
        - task:list
        - task:status
        - status
        - help
      
      # 敏感字段
      sensitive-keys:
        - password
        - secret
        - token
        - key
        - api-key
        - credential
        - auth
        - private-key
        - access-token
        - refresh-token
      
      # 安全检测正则表达式
      dangerous-chars-pattern: "[;|&$`\\{}\\[\\]\\(\\)\\*\\?<>]"
      sql-injection-pattern: "(\\b(SELECT|INSERT|UPDATE|DELETE|DROP|CREATE|ALTER|EXEC|UNION)\\b)|(--|#|/\\*)"
      script-injection-pattern: "<script|javascript:|on\\w+\\s*="
    
    # 输出配置
    output:
      default-format: text
      color-enabled: true
      
    # 交互式配置
    interactive:
      enabled: true
      history-size: 1000
      history-file: "${user.home}/.ooder/cli-history"
      prompt: "ooder> "
      
    # 任务配置
    task:
      default-timeout: 60
      cleanup-interval: 3600
      max-concurrent: 10

ooder:
  sdk:
    enabled: true
    agent-id: my-agent
    agent-name: My Agent
    agent-type: WORKER
    endpoint: http://localhost:8080
    discovery-enabled: true
    heartbeat-interval: 30000

@SpringBootApplication
public class AgentApplication {
    
    @Bean
    public OoderCli ooderCli(SkillRegistry skillRegistry,
                             SkillInstaller skillInstaller,
                             SkillInvoker skillInvoker,
                             CollaborativeSceneGroupManager sceneGroupManager) {
        OoderCli cli = OoderCli.builder()
            .skillRegistry(skillRegistry)
            .skillInstaller(skillInstaller)
            .skillInvoker(skillInvoker)
            .sceneGroupManager(sceneGroupManager)
            .build();
        
        cli.initializeAdapters();
        return cli;
    }
    
    public static void main(String[] args) {
        SpringApplication.run(AgentApplication.class, args);
    }
}

public class StandaloneCliApp {
    public static void main(String[] args) {
        // 创建 SDK 实例
        OoderSDK sdk = OoderSDK.builder()
            .agentId("cli-agent")
            .agentName("CLI Agent")
            .build();
        
        // 创建 CLI 实例
        OoderCli cli = OoderCli.builder()
            .skillRegistry(sdk.getSkillRegistry())
            .skillInstaller(sdk.getSkillInstaller())
            .skillInvoker(sdk.getSkillInvoker())
            .sceneGroupManager(sdk.getSceneGroupManager())
            .build();
        
        // 初始化适配器
        cli.initializeAdapters();
        
        // 运行 CLI
        int exitCode = cli.run(args);
        System.exit(exitCode);
    }
}

<settings>
    <localRepository>D:\maven\.m2</localRepository>
    
    <mirrors>
        <mirror>
            <id>aliyun</id>
            <mirrorOf>central</mirrorOf>
            <name>Aliyun Maven Mirror</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
</settings>

# 克隆仓库
git clone https://github.com/oodercn/ooder-sdk.git
cd ooder-sdk

# 编译安装
mvn clean install -DskipTests

# 构建 CLI 模块
cd agent-sdk/agent-sdk-cli
mvn clean package

# 方式1: 直接运行主类
java -cp target/agent-sdk-cli-3.0.3.jar net.ooder.sdk.cli.OoderCli

# 方式2: 进入交互式模式
java -cp target/agent-sdk-cli-3.0.3.jar net.ooder.sdk.cli.OoderCli

# 方式3: 执行单个命令
java -cp target/agent-sdk-cli-3.0.3.jar net.ooder.sdk.cli.OoderCli skill:list

$ java -cp target/agent-sdk-cli-3.0.3.jar net.ooder.sdk.cli.OoderCli

Ooder Agent SDK CLI v3.1.0
Type 'help' for available commands or 'exit' to quit.

ooder>

# 查看帮助
ooder> help

# 查看系统状态
ooder> status

# 列出所有技能
ooder> skill:list

# 安装技能
ooder> skill:install --source ./my-skill.jar

# 启动技能
ooder> skill:start --skill-id my-skill

# 退出
ooder> exit

# 列出所有技能
java -cp ... net.ooder.sdk.cli.OoderCli skill:list

# 安装技能
java -cp ... net.ooder.sdk.cli.OoderCli skill:install --source ./skill.jar

# 查看技能详情
java -cp ... net.ooder.sdk.cli.OoderCli skill:info --skill-id rag-skill

# 创建场景
java -cp ... net.ooder.sdk.cli.OoderCli scene:create --group-id meeting-001 --main video-call

# JSON 格式输出
java -cp ... net.ooder.sdk.cli.OoderCli skill:list --output json

# 表格格式输出
java -cp ... net.ooder.sdk.cli.OoderCli skill:list --output table

# 详细输出
java -cp ... net.ooder.sdk.cli.OoderCli skill:list --verbose

# 步骤1: 安装 RAG 技能
ooder skill:install --source https://repo.ooder.cn/skills/rag-skill-1.0.0.jar

# 步骤2: 查看安装结果
ooder skill:list --status INSTALLED

# 步骤3: 启动技能
ooder skill:start --skill-id rag-skill

# 步骤4: 执行技能命令
ooder skill exec rag-skill:reindex --knowledgeBase ./docs

# 步骤5: 查询任务状态
ooder task:status --task-id <task-id>

# 步骤1: 创建场景组
ooder scene:create --group-id meeting-001 \
    --main video-call \
    --collaborative whiteboard,screen-share,chat

# 步骤2: 查看场景信息
ooder scene:info --group-id meeting-001

# 步骤3: 调用场景能力
ooder scene:invoke --group-id meeting-001 \
    --capability video-call:start \
    --participants user1,user2,user3

# 步骤4: 发布场景事件
ooder scene:event --group-id meeting-001 \
    --event-type participant.joined \
    --user user4

# 方式1: 通过 agent-chat 小助手
用户: "帮我安装 cli-console 能力"
Agent: 正在为您安装 skills-cli-console...
       ✓ 安装成功
       ✓ 已启用 cli-console 能力
       您现在可以通过对话方式执行 CLI 命令了！

# 方式2: 通过传统 CLI 命令
ooder skill:install --source skills-cli-console --auto-discover

# application.yml
ooder:
  cli-console:
    enabled: true
    
    # Agent-Chat 配置
    agent-chat:
      enabled: true
      welcome-message: "您好！我是 CLI 助手，可以通过对话帮您执行命令。"
      
    # 钉钉集成配置
    dingtalk:
      enabled: true
      webhook: ${DINGTALK_WEBHOOK}
      secret: ${DINGTALK_SECRET}
      at-all: false
      
    # 微信集成配置
    wechat:
      enabled: true
      corp-id: ${WECHAT_CORP_ID}
      agent-id: ${WECHAT_AGENT_ID}
      secret: ${WECHAT_SECRET}
      
    # 飞书集成配置
    feishu:
      enabled: true
      app-id: ${FEISHU_APP_ID}
      app-secret: ${FEISHU_APP_SECRET}
      
    # LLM 配置
    llm:
      enabled: true
      provider: openai
      model: gpt-4
      temperature: 0.7
      max-tokens: 2000

# 用户输入自然语言
用户: "我想安装一个 RAG 技能"

# LLM 转换为命令
LLM 建议: ooder skill:install --source <rag-skill-url>

# 用户确认后执行
ooder> skill:install --source https://repo.ooder.cn/skills/rag-skill-1.0.0.jar

# 用户输入部分命令
ooder> skill:i

# LLM 提供补全建议
[1] skill:info      - 查看技能详情
[2] skill:install   - 安装技能
[3] skill:invoke    - 调用技能能力

# 用户选择或继续输入
ooder> skill:install --source ./my-skill.jar

# 用户输入错误命令
ooder> skill:install my-skill.jar

# CLI 返回错误
错误: 缺少必需参数 --source

# LLM 提供修复建议
LLM 建议: 您可能想要执行以下命令：
  ooder skill:install --source my-skill.jar

是否执行建议的命令？(y/n)

# 用户输入
用户: "创建一个包含视频通话和白板的协作场景"

# LLM 解析并生成命令
LLM 分析:
  - 场景类型: 协作场景
  - 主要能力: 视频通话
  - 协作能力: 白板

生成命令:
  ooder scene:create --group-id collab-001 \
      --main video-call \
      --collaborative whiteboard

# 执行命令
ooder> scene:create --group-id collab-001 --main video-call --collaborative whiteboard

场景组创建成功:
  - Group ID: collab-001
  - Main Capability: video-call
  - Collaborative Capabilities: [whiteboard]
  - Status: CREATED

# 用户描述需求
用户: "我需要一个能够处理文档检索和问答的技能"

# LLM 分析并推荐
LLM 推荐:
  基于您的需求，推荐以下技能：

  [1] rag-skill (v1.2.0)
      - 文档检索与问答
      - 支持多种文档格式
      - 内置向量检索引擎
      
  [2] qa-skill (v2.0.0)
      - 智能问答系统
      - 支持多轮对话
      - 知识图谱集成

选择要安装的技能 (1-2): 1

# 安装推荐的技能
ooder> skill:install --source https://repo.ooder.cn/skills/rag-skill-1.2.0.jar

# 模板1: 技能安装
ooder> template skill-install
请输入技能源地址: https://repo.ooder.cn/skills/my-skill.jar
是否强制安装? (y/n): y
生成命令: ooder skill:install --source https://repo.ooder.cn/skills/my-skill.jar --force

# 模板2: 场景创建
ooder> template scene-create
请输入场景组ID: meeting-001
请输入主要能力: video-call
请输入协作能力(逗号分隔): whiteboard,chat
生成命令: ooder scene:create --group-id meeting-001 --main video-call --collaborative whiteboard,chat

ooder
├── Core Commands (核心命令)
│   ├── skill:list          # 列出所有 Skills
│   ├── skill:info          # 查看 Skill 详情
│   ├── skill:install       # 安装 Skill
│   ├── skill:uninstall     # 卸载 Skill
│   ├── skill:start         # 启动 Skill
│   ├── skill:stop          # 停止 Skill
│   ├── skill:update        # 更新 Skill
│   └── skill exec          # 执行 Skill 命令
│
├── Scene Commands (场景命令)
│   ├── scene:create        # 创建场景
│   ├── scene:list          # 列出场景
│   ├── scene:info          # 查看场景详情
│   ├── scene:invoke        # 调用场景能力
│   └── scene:event         # 发布场景事件
│
├── Task Commands (任务命令)
│   ├── task:list           # 列出所有任务
│   └── task:status         # 查询任务状态
│
└── System Commands (系统命令)
    ├── status              # 查看系统状态
    └── help                # 查看帮助