@duvoai/cli (英语)

命令行接口 杜沃语Name 大众API.

安装

npm install -g @duvoai/cli

需要22.22.0节点.

或安装独立的二进制(不需要节点.js):

curl -fsSL https://duvo.ai/install-cli.sh | sh

更新

duvo update

duvo update 检测CLI是如何安装和更新的: npm 安装运行 npm install -g @duvoai/cli@latest; 独立 二进制下载最新版本,验证其校验和,以及 替换自己。 使用 duvo update --check 看有没有更新 版本存在而不安装它.

折旧通知

当 API 标记一个已贬值的终点时, CLI 打印出一个短的 警告到 stderr (如果服务器提供日落日期和链接) ,他们。 折旧警告总是显示,它们不影响Stdout和 不能寂灭.

快开始

# 1. Log in (prompts for your API key and saves it to a profile)
duvo login --name default

# 2. Verify you're logged in
duvo whoami

# 3. Create your first agent (interactive)
duvo agents create

# ...or create one non-interactively with flags
duvo agents create --name "My agent" --input "What this agent should do"

# ...optionally pick the LLM the agent runs on
duvo agents create --name "My agent" --model claude-opus-4-7

# 4. Kick off a run and watch it complete
duvo runs start --agent <agent-id> --follow

# Switch an existing agent to a different model later
duvo agents set-model <agent-id> --model claude-opus-4-7

从团队设置中获取 API 密钥 : https://app.duvo.ai/ settings/api-keys (英语)。 。 。 .

认证

您可以保存多个配置文件并在它们之间切换:

duvo login --name acme         # prompts for the API key
duvo login --name team-2       # prompts for the API key

duvo profiles list             # show saved profiles
duvo profiles use acme         # set the default profile
duvo --profile team-2 whoami   # one-off override for a single command

工作流量

启动运行和流出消息

# Start a run and tail messages until it completes
duvo runs start --agent <agent-id> --message "Process this week's reports" --follow

# Tail messages on a run that's already in progress
duvo runs messages <run-id> --follow

--follow 每两秒投票一次,跑道达到时则离开 终端状态( o)completed, (中文(简体) ), failed, (中文(简体) ), stopped,或 error) (中文(简体) ). 最终线 总是显示运行状态, 例如 . Run completed.

为了在程序上消耗溪流 --follow --json: 每个新 消息被打印为JSON对象在自己的行上(NDJSON).

duvo runs messages <run-id> --follow --json | while IFS= read -r line; do
  echo "$line" | jq -r '.text_content // empty'
done

脚本使用 --json

每个命令都接受 --json 发送原始的 API 响应而不是 表格或密钥/值视图——用于管道 jq。 。 。 .

# Start a run and capture the ID
RUN_ID=$(duvo runs start --agent "$AGENT_ID" --message "Go" --json | jq -r '.run.id')

# Follow messages on that run
duvo runs messages "$RUN_ID" --follow

为代理修改建立连接

整合是需要实况转播的修订版(a)段 连接). 使用 revision-integrations 可以看到槽和 revision-integrations connections 将你和他们的联系.

# 1. See the integration slots on a revision
duvo revision-integrations list --agent <agent-id> --revision <revision-id>
# INTEGRATION ID  TYPE   NAME   SLOT ID   CREATED
# 22222222-...    gmail  Gmail  slot-1    2026-04-15…

# 2. List your available connections
duvo connections list --type gmail

# 3. Pin a connection to the slot (use SLOT ID or INTEGRATION ID from step 1)
duvo revision-integrations connections pin <connection-id> \
  --agent <agent-id> --revision <revision-id> --integration slot-1

# 4. Verify
duvo revision-integrations connections list \
  --agent <agent-id> --revision <revision-id> --integration slot-1

说明: 这个 --integration 旗帜接受 衬衫标识 或 综合编号 来自 revision-integrations list。 。 。 .

队列工作

# Create a queue
duvo queues create --name "support-tickets"

# On a team that has moved to the Automations workspace, a queue has to be
# created inside an automation — `duvo automations list` gives you the id
duvo queues create --name "support-tickets" --automation-id <automation-id>

# `duvo agents create` takes the same flag; without it a new agent gets an
# automation of its own rather than joining an existing one
duvo agents create --name "Ticket triage" --automation-id <automation-id>

# Create cases in bulk from a JSON file (up to 100)
duvo cases create --queue <queue-id> --from-file cases.json

# List pending cases
duvo cases list --queue <queue-id> --status pending

# Count pending cases without fetching Case rows
duvo cases list --queue <queue-id> --status pending --count-only

# Get case status counts for several queues in one call
duvo queues stats --queue-ids <id1>,<id2>,<id3>

# Bulk re-process pending cases on an agent
duvo cases bulk-reprocess --queue <queue-id> --agent <agent-id> \
  --ids <id1>,<id2>,<id3>

人类的 " 落地 " 反应

当运行暂停并提问时,直接从CLI回复:

duvo runs get <run-id>              # shows pending_human_request details
duvo runs respond <run-id>          # defaults to the current pending request

图标

在可能情况下,Clarity命令自动检测进程版本. 遗留的v1格式使用单一的分析有效载荷,而v2则以当前进程和转换建议版本为快照. 使用 v2 等特定命令 versions, (中文(简体) ), current, (中文(简体) ), proposal, (中文(简体) ), compare, (中文(简体) ), gaps, (中文(简体) ), evidence,以及 readiness 仅用于v2进程.

默认输出为摘要一和紧凑. JSON产出还包括一个紧凑 summary 块中,除 --include-transcripts 通过.

duvo agents schedules list --all-users 返回最多一个响应的行值。 在一个行程比这还多的代理上,CLI警告说,有的失踪了,它确实返回的行是按创建日期算最老的.