CLI 参考

pip install shannon-sdk

shannon --help

git clone https://github.com/Kocoro-lab/Shannon.git
cd Shannon/clients/python
pip install -e .

shannon --base-url http://localhost:8080 submit "Hello world" --wait

shannon --base-url http://localhost:8080 --api-key YOUR_API_KEY \
  submit "Hello world" --wait

export SHANNON_BASE_URL=http://localhost:8080   # 或 http://localhost:8080
export SHANNON_API_KEY=sk_your_key_here
# export SHANNON_BEARER_TOKEN=eyJ...    # API key 的替代方式

shannon submit "Hello world" --wait

shannon [--base-url URL] [--api-key KEY] [--bearer-token TOKEN] COMMAND [OPTIONS]

shannon submit QUERY [OPTIONS]

# 简单任务
shannon submit "2+2等于多少？" --wait

# 深度研究（带引用）
shannon submit "量子计算最新进展" \
  --force-research --research-strategy deep --wait

# 低成本模式
shannon submit "总结这段文字" --model-tier small --mode simple --wait

# 指定模型和提供商
shannon submit "分析趋势" --model-override gpt-5-nano-2025-08-07 --provider-override openai --wait

# 多智能体 swarm
shannon submit "比较前3大云提供商的AI工作负载" --swarm --wait

# 关联会话
shannon submit "后续问题" --session-id my-session --wait

shannon status TASK_ID

shannon cancel TASK_ID [--reason REASON]

shannon pause TASK_ID [--reason REASON]

shannon resume TASK_ID [--reason REASON]

shannon control-state TASK_ID

shannon stream WORKFLOW_ID [OPTIONS]

# 流式传输所有事件
shannon stream workflow-xyz789

# 仅流式传输 LLM 输出和完成事件
shannon stream workflow-xyz789 --types LLM_OUTPUT,WORKFLOW_COMPLETED

shannon review-get WORKFLOW_ID

shannon review-feedback WORKFLOW_ID MESSAGE [--version N]

shannon review-approve WORKFLOW_ID [--version N]

shannon approve APPROVAL_ID WORKFLOW_ID [--approve | --reject] [--feedback TEXT]

# 批准
shannon approve approval-001 workflow-xyz789 --feedback "没问题"

# 拒绝
shannon approve approval-001 workflow-xyz789 --reject --feedback "需要修改"

shannon session-list [--limit N] [--offset N]

shannon session-get SESSION_ID [--no-history]

shannon session-title SESSION_ID TITLE

shannon session-delete SESSION_ID

shannon schedule-create NAME CRON QUERY [OPTIONS]

分  时  日  月  周
 0   9   *   *  1-5     = 工作日 9:00
 0  */4   *   *   *     = 每4小时
 0   0   *   *   1      = 每周一午夜

shannon schedule-create "每日AI新闻" "0 9 * * *" "最新AI新闻摘要" \
  --timezone Asia/Shanghai --force-research --research-strategy quick

shannon schedule-list [--page N] [--page-size N] [--status ACTIVE|PAUSED]

shannon schedule-get SCHEDULE_ID

shannon schedule-update SCHEDULE_ID [--name N] [--cron C] [--query Q] [--timezone T] [--budget B] [--timeout T] [--clear-context]

shannon schedule-pause SCHEDULE_ID [--reason REASON]

shannon schedule-resume SCHEDULE_ID [--reason REASON]

shannon schedule-delete SCHEDULE_ID

shannon schedule-runs SCHEDULE_ID [--page N] [--page-size N]

shannon tools-list [--category CATEGORY]

shannon tools-list

Name                      Description
--------------------------------------------------------------------------------
web_search                Search the web for information
calculator                Evaluate mathematical expressions

shannon tool-get NAME

shannon tool-get web_search

shannon tool-exec NAME [--arguments JSON] [--session-id ID]

shannon tool-exec web_search --arguments '{"query": "Shannon AI"}'

shannon agents-list

shannon agent-get AGENT_ID

shannon agent-exec AGENT_ID --input JSON [--session-id ID] [--stream]

shannon agent-exec agent-001 --input '{"query": "分析 Q4 趋势"}'

shannon swarm-message WORKFLOW_ID MESSAGE

shannon swarm-message workflow-xyz789 "聚焦成本分析"

shannon session-files SESSION_ID [--path SUBDIR]

shannon session-files my-session

shannon session-file-get SESSION_ID PATH

shannon session-file-get my-session report.md

shannon memory-files

shannon memory-file-get PATH

shannon memory-file-get profile.md

shannon skills-list [--category CATEGORY]

shannon skill-get NAME

shannon skill-versions NAME