Tinet Agent CLI 产品说明

快速阅读

Tinet Agent CLI（以下简称“CLI”）是面向智能体平台的命令行编排工具。它让实施人员、开发人员以及 Cursor、Codex 等智能体，用稳定、可机器解析的命令完成：登录与切换企业、发现平台能力、在本地编辑 DSL，以及调试和发布智能体、工作流与对话流。

使用者可以通过 CLI：

• 使用开发者中心 AccessKey 连接企业，并在多个企业 profile 之间切换。
• 发现分类、模型、内置工具、场景 playbook 和 DSL 契约，避免凭记忆拼参数。
• 拉取、校验、调试和发布 Agent，以及工作流、对话流与工作流工具。
• 按契约调用智能知识库（AIKB）能力。
• 把 Skill 安装到 Cursor 等工具，使智能体按官方约定调用 CLI。

CLI 是智能体平台的官方适配层，不替代智能体控制台，也不会绕过企业权限、分类模型和发布校验。写操作必须显式确认后才会改变平台状态。

阅读地图

一、文档说明

1.1 文档目的

本文说明 CLI 的产品定位、核心对象、运行链路、配置项、能力范围、典型场景、安全确认规则和实施验收方法，供售前、项目经理、实施顾问、开发人员和智能体协同使用。

1.2 产品范围

本文主要说明：

• CLI 的安装、企业连接、多 profile 管理和 Skill 安装。
• Agent、工作流、对话流、内置工具、工作流工具和智能知识库相关命令。
• 本地 DSL 的发现、校验、调试、预览同步和发布。
• --json / --no-input 的机器调用约定，以及 --yes / --overwrite / --dry-run 的风险控制。
• 上线准备、验收和常见问题处理。

如项目还涉及智能体控制台页面配置、具体分类与模型清单、知识库业务口径或呼叫中心 OpenAPI 调用，建议结合对应专题文档或联调方案一起确认。

1.3 版本依据

本文以本机已验证的 taco 0.0.7 命令契约为基准。该版本要求 Python 3.12 及以上。本文附录 G 收录当前版本的全部命令、参数、必填项和默认值；运行时仍以当前安装版本的 taco help 为准。

二、产品总览

2.1 产品定位

CLI 位于“使用者或智能体”与“智能体平台”之间，负责：

1. 发现当前版本支持的命令、场景、schema 和示例。
2. 读取当前企业 profile 并完成授权。
3. 在本地维护 Agent JSON DSL 或工作流 / 对话流 YAML DSL。
4. 调用平台完成创建、拉取、校验、调试、同步草稿和发布。
5. 输出可读结果或机器可读 JSON，供人工核验或智能体分支。

2.2 产品价值

2.3 适用方式

• 人工交互：在终端执行命令，查看摘要或 JSON。
• 智能体协作：先安装 Skill，再由 Cursor 等工具按场景发现能力并调用 CLI。
• 多企业交付：为每个企业保存独立 profile，显式切换后再操作。
• 自动化环境：使用 --json --no-input，密钥通过环境变量注入。

三、核心概念

3.1 命令入口

安装后的命令名为 taco，Python 包名为 tinet-agent-cli。

taco --version
taco help -o json

3.2 Profile

Profile 是本机保存的企业授权配置。推荐使用开发者中心 AccessKey 连接；AccessKey profile 以企业 ID 作为唯一名称。

• taco profile connect：创建或修改企业 profile。
• taco profile list / show / use：查看、确认和切换。
• --profile：仅本次命令使用指定 profile。
• 首次连接会自动成为当前 profile；后续再连接其他企业时，只创建或更新，不会悄悄切换当前企业。

写操作前必须先确认当前企业，避免发到错误租户。

3.3 本地 DSL

DSL 是智能体或流程在本地的声明式描述：

Agent 只改本地 DSL，不手写服务端 ID。分类 code、模型 ID、Provider ID、工作流工具 ID 都必须通过发现命令获得。

3.4 场景、Schema 与示例

任务开始前应先发现，再编辑，不凭记忆拼命令或字段。

3.5 全局选项

业务命令建议同时加 --json --no-input。成功结果读标准输出，失败信息读标准错误，并按错误码分支，不依赖中文提示文本。

3.6 确认、覆盖与预览

3.7 配置生效层次

实施和验收时应区分：

1. 本地已安装：taco --version 可用，Skill 已安装。
2. 企业已连接：taco profile show 显示正确企业，密钥已脱敏。
3. 本地 DSL 已就绪：校验通过，调试结果符合预期。
4. 平台实际生效：创建、同步草稿或发布后，控制台或回查命令看到目标对象已更新。

命令执行结束不等于线上配置一定生效；发布类操作应回查应用详情或控制台。

四、对象关系与运行链路

4.1 发现到发布主链路

确认当前企业 profile
        ↓
发现分类 / 模型 / 工具 / 场景 / schema
        ↓
创建或拉取远端对象，生成本地 DSL
        ↓
按 schema 编辑本地 DSL（不写入密钥）
        ↓
本地校验
        ↓
调试运行（测试应用）
        ↓
工作流 / 对话流：dry-run 预览 → 确认后同步草稿
        ↓
使用方确认企业、对象和影响后加 --yes 发布
        ↓
回查远端对象，确认业务实际生效

4.2 工作流工具挂到智能体

创建并校验工作流 DSL
        ↓
dry-run / apply 同步草稿
        ↓
发布工作流
        ↓
按需写入工作流密钥
        ↓
把已发布工作流注册为工具
        ↓
用发现到的工作流工具 ID 挂到 Agent DSL
        ↓
校验、调试（触发与不触发工具各一次）
        ↓
确认后发布 Agent

工作流必须先发布，才能注册为工具。挂到 Agent 时使用工作流工具 ID，不是工作流应用 ID。

4.3 智能体调用约定

taco profile show          确认企业，不展示 Secret
        ↓
taco help / scenario / schema
        ↓
只改本地 DSL
        ↓
run / validate 等调试或只读命令
        ↓
写操作先展示确认信息，用户同意后再加 --yes

五、能力地图

5.1 连接、发现与协同

5.2 智能体

5.3 工作流与对话流

工作流 DSL 可编排 HTTP 请求、代码执行、知识库检索、大模型调用、文本模板，以及条件分支、并行和列表迭代。对话流以回复内容为终点，适合对话场景。

5.4 工具凭据与智能知识库

AIKB 需要 AccessKey profile。控制台令牌授权方式不用于 AIKB。获取文件上传地址类操作会在本地完成上传，输出中不包含临时上传地址。

六、产品功能说明

6.1 安装与版本

需要 Python 3.12 及以上，并从企业制品库安装：

pipx install tinet-agent-cli
taco --version

也可使用 pip / pip3 安装。连接平台时若提示版本过低，按原安装方式安装满足要求的版本；CLI 不提供 taco upgrade 子命令。安装或更换版本后，建议重新安装 Skill，使智能体指引与当前 CLI 一致。

6.2 企业连接配置项

推荐使用开发者中心 AccessKey 连接企业，按项目要求管理访问凭证。

taco profile connect \
  --endpoint <开发者中心平台地址> \
  --access-key-id <access-key-id>

AccessKeySecret 可省略后按提示隐藏输入，自动化环境使用 TACO_ACCESS_KEY_SECRET。不要把 Secret 写进对话、DSL 或日志。

连接过程会检查 CLI 最低版本，再换取 CLI 所需访问令牌，并用返回的企业 ID 作为 profile 名称。

6.3 多企业切换

taco profile list
taco profile use <enterprise_id>
taco profile show

运营交付不同企业时：先连接、再显式切换、再确认当前企业，最后才发现、调试或发布。删除 profile 必须加 --yes。删除本地 profile 不会删除平台侧应用，但后续本地命令会失去该企业授权。

6.4 控制台令牌授权方式

如项目仍使用控制台刷新令牌方式登录，可用 auth status / refresh 管理。新接入企业和 AIKB 调用建议使用 AccessKey profile。两种授权配置可并存于本机，互不影响已保存的 profile。

6.5 接到 Cursor

taco skills install --agent cursor --yes
taco skills status --agent cursor

Skill 会约束智能体：先发现再调用、使用 JSON 输出、不绕过 CLI 直连平台接口、写操作先确认、不输出密钥。新开对话后智能体才会稳定读取最新 Skill。

6.6 发现与本地编辑

taco --json --no-input scenario list
taco --json --no-input scenario describe agent-basic
taco --json --no-input category list
taco --json --no-input model list --category <category-code>
taco --json --no-input schema agent -o json

编辑规则：

• 只修改 schema 支持的字段。
• 不把 Provider 凭据、工作流密钥、AccessKey 或令牌写入 DSL。
• 工具 form 参数放入参数文件；运行时大模型参数与凭据分开管理。
• 挂载工具使用 agent tool add，不手写工具列表。

6.7 调试运行

taco --json --no-input agent validate --dsl agent.json --category <category-code>
taco --json --no-input agent run <app-id> --dsl agent.json --query "测试问题"

调试可能真实触发 HTTP 工具。执行前应确认指向测试地址，即使是查询类请求也按可能产生外部副作用处理。

6.8 写操作确认口径

发起确认时应至少展示：

用户明确同意后，再在命令末尾加 --yes。未确认当前企业，不得执行写操作。

典型写操作包括：创建远端应用、发布 Agent / 工作流 / 对话流 / 工作流工具、写入 Provider 凭据、写入工作流密钥、删除 profile 或凭据。

工作流 / 对话流同步草稿应先 --dry-run，确认变更计划后再 --yes 执行 apply。

6.9 凭据与密钥

Provider 凭据和工作流密钥只能从标准输入或环境变量注入，不能出现在 DSL、命令行明文或对话里。credential schema / status 只读字段定义和脱敏状态，不回显明文。若密钥已出现在聊天或日志中，应视为泄露并轮换。

七、典型业务场景

7.1 创建并发布基础智能体

对应内置场景 agent-basic。

1. 确认当前企业 profile。
2. 发现真实分类和该分类可用模型，读取模型参数规则。
3. 创建 Agent 并得到本地 DSL。
4. 按 schema 调整提示词、开场白等支持字段。
5. 本地校验后，在测试应用上调试，必要时续聊或多轮验证。
6. 确认企业、应用 ID 和“将更新线上配置”后发布。
7. 回查发布结果，并确认本地 DSL 是删除还是按 --keep-dsl 保留。

7.2 为智能体挂载内置工具

对应内置场景 agent-builtin-tool。

1. 发现 Provider 和工具，读取参数与凭据字段定义。
2. 经确认后，用环境变量或标准输入写入租户共享凭据。
3. 把 form 参数写入本地参数文件，挂载到 Agent DSL。
4. 保留原有提示词，并补充何时调用、失败如何处理、不得编造工具结果等说明。
5. 分别调试“应触发工具”和“不应触发工具”的问题，确认事件符合预期后再发布。

7.3 工作流工具编排

对应内置场景 agent-workflow-tool。

1. 按工作流 schema 编写 YAML，本地校验。
2. --dry-run 预览草稿差异，确认后再同步。
3. 发布工作流；需要密钥时从环境变量写入。
4. 将已发布工作流注册为工具，查询真实工具 ID 和机器名。
5. 以工作流工具类型挂到 Agent，再校验、调试和发布 Agent。

7.4 多企业运营交付

1. 为每个企业执行一次 AccessKey 连接。
2. 使用 profile use 显式切换。
3. profile show 确认企业 ID 和服务地址。
4. 再执行发现、调试或发布。独立企业建议分目录、分会话处理，降低上下文串扰。

7.5 Cursor 辅助编排

用户可直接提出“按基础智能体场景创建一个测试助手”“把某工作流注册成工具”等请求。Cursor 应先确认企业、读取场景和 schema，只改本地 DSL；涉及创建、发布、凭据或密钥时，必须展示确认信息并等待明确同意。

八、上线准备与运营建议

8.1 环境准备

• Python 3.12 及以上。
• 已配置企业制品库，能够安装 tinet-agent-cli。
• 能够访问对应开发者中心地址。
• 接口密钥已分配智能体 CLI 授权。
• 调试和首次发布使用专用测试应用。
• 本机 profile 和 DSL 目录仅允许受信任人员访问。

8.2 首次配置验收

1. taco --version，确认 0.0.7 或项目指定版本。
2. taco profile show，确认企业 ID，Secret 为脱敏显示。
3. taco --json --no-input category list，确认只读发现可用。
4. taco skills status --agent cursor，确认 Skill 与当前 CLI 一致。
5. 在测试应用上完成一次校验和调试。
6. 对工作流执行一次 --dry-run。
7. 明确授权后，再做一次低风险写操作并回查。

8.3 运营建议

• 生产固定 CLI 版本，版本变更前先在测试企业验证，并同步 Skill。
• 每个企业使用独立 profile，名称即企业 ID，切换后立刻 show。
• 发布前固定记录：版本、企业、应用 ID、DSL 文件、操作类型。
• 定期清理不再使用的 profile 和本地 DSL。
• HTTP 类节点只指向测试地址，正式环境发布单独授权。

8.4 变更影响

• 更换 CLI 版本可能影响命令、schema、场景步骤和 Skill 指纹，发布前应重新验收。
• profile use 会影响后续未指定 --profile 的全部命令。
• Agent 发布会覆盖远端有效配置；成功后默认删除本地 DSL。
• 写入 Provider 凭据会影响租户内共享该 Provider 的调用。
• 删除本地 profile 或 Skill 不影响平台已发布应用，但会影响后续本地协同。

九、与周边能力的关系

十、FAQ

10.1 和呼叫中心 OpenAPI CLI 是不是同一个工具？

不是。呼叫中心 OpenAPI CLI 的命令是 zenava，用于座席、话单、任务等开放接口。本工具命令是 taco，用于智能体平台的 DSL 编排与发布。

10.2 为什么 AccessKey 填对了仍连接失败？

优先核对开发者中心地址是否与企业环境一致、密钥是否属于该企业，以及是否已分配智能体 CLI 授权。同时确认 CLI 版本满足平台最低要求。

10.3 为什么控制台令牌不能调用知识库？

AIKB 只支持 AccessKey profile。控制台令牌授权方式可用于部分既有流程，知识库和新接入建议使用 profile connect。

10.4 --yes 和 --overwrite 有什么区别？

--yes 确认创建、发布、写凭据等会改变平台或明确高风险的操作。--overwrite 只表示允许覆盖本地已存在的 DSL 文件。拉取覆盖本地文件时即使没有 --yes，仍应先取得使用方同意。

10.5 为什么发布成功后本地文件不见了？

Agent 发布成功后默认删除本地 DSL。需要保留时在发布命令中加 --keep-dsl。

10.6 挂工作流工具时为什么找不到？

确认工作流已发布，再查询工作流工具 ID。Agent 侧 Provider 应使用该工具 ID，不能使用工作流应用 ID。

10.7 智能体为什么一直猜命令？

尚未安装 Skill，或 Skill 指纹与当前 CLI 不一致。执行 taco skills install --agent cursor --yes 后新开对话。智能体应按 taco help -o json 发现命令，不凭记忆编写。

10.8 调试时如何停止任务？

使用 --stream-events 获取任务 ID，再在另一进程调用对应的 stop 命令。

10.9 CLI 能否替代智能体控制台？

CLI 更适合标准场景编排、版本化 DSL、智能体协同和批量交付。涉及可视化编排、权限管理和复杂运营时，仍建议结合控制台使用。

十一、总结

Tinet Agent CLI 把企业授权、能力发现、本地 DSL、调试和发布收口成一套可确认的命令契约，降低了智能体配置交付和 Cursor 协同的不确定性。上线时应重点管控：企业 profile、AccessKey 权限、测试应用、写操作二次确认、密钥不入库，以及 Skill 与 CLI 版本一致。

附录 A：入口与权限

A.1 标准入口

taco

接到 Cursor 后，由 Skill 指引智能体调用本机 taco。

A.2 权限来源

CLI 不单独定义业务权限。实际可发现、调试和发布的对象由以下因素共同决定：

• 当前 profile 对应的企业。
• 开发者中心 AccessKey 及其 CLI 授权。
• 企业已开通的智能体分类、模型和工具。
• 目标应用是否存在、是否为草稿或已发布状态。
• 使用方是否对写操作给出确认。

附录 B：关键字段口径

附录 C：实施检查清单

• Python 版本不低于 3.12。
• 已从企业制品库安装 CLI，taco --version 符合项目要求。
• 开发者中心地址与企业环境一致。
• AccessKey 已分配智能体 CLI 授权。
• profile show 企业正确，Secret 脱敏。
• 只读发现命令可用。
• Cursor Skill 已安装且与当前 CLI 一致。
• 分类、模型、工具 ID 均来自发现结果。
• 本地 DSL 中无密钥、令牌或凭据。
• 调试使用测试应用，HTTP 节点指向测试地址。
• 工作流 / 对话流已 --dry-run。
• 写操作已展示企业、对象和影响，并取得确认。
• 发布后已回查远端对象。
• Agent 发布后已确认本地 DSL 删除或保留策略。

附录 D：常见问题速查

附录 E：术语表

附录 F：文档导航

• 产品定位、配置、场景与实施：本文。
• 呼叫中心开放接口命令行：Zenava CLI 产品说明。
• 全部命令和参数：本文附录 G。
• 当前版本实际帮助：taco help -o json 以及 taco <命令> --help。
• 平台侧使用指引与完整命令参考：以项目提供的 Tinet Agent CLI 说明页为准。

附录 G：全部命令与参数

以下内容基于 taco 0.0.7 的结构化帮助生成，
共 96 个命令节点、72 个可执行命令和 189 个参数定义。
参数是否必填、默认值和可选值以当前安装版本的帮助信息为准。

G.1 全局命令

G.1 taco

Tinet Agent CLI Orchestrator

子命令： agent、aikb、app、auth、category、chatflow、credential、example、help、model、profile、scenario、schema、skills、tool、workflow

G.1.1 taco agent

Agent 智能体管理

子命令： call、create、operation、publish、pull、run、stop、tool、validate

本级命令无专属参数。

G.1.1.1 taco agent call

校验参数并执行 Agent 数据 OpenAPI operation。

G.1.1.2 taco agent create

创建 Agent 并把服务端默认配置写入本地 DSL。

G.1.1.3 taco agent operation

发现 Agent 数据 OpenAPI operation

子命令： describe、list、search

本级命令无专属参数。

G.1.1.3.1 taco agent operation describe

查看 Agent 数据 OpenAPI operation 完整契约。

G.1.1.3.2 taco agent operation list

列出 Agent 数据 OpenAPI operation。

G.1.1.3.3 taco agent operation search

按关键词搜索 Agent 数据 OpenAPI operation。

G.1.1.4 taco agent publish

发布本地 Agent DSL 并可在成功后删除文件。

G.1.1.5 taco agent pull

从服务端拉取 Agent model_config 到本地 DSL。

G.1.1.6 taco agent run

使用本地 DSL 通过 SSE 调试 Agent。

G.1.1.7 taco agent stop

使用 task_id 停止正在运行的 Agent 调试任务。

G.1.1.8 taco agent tool

本地 Agent DSL 工具挂载

子命令： add、list、remove

本级命令无专属参数。

G.1.1.8.1 taco agent tool add

发现工具并挂载到本地 Agent DSL。

G.1.1.8.2 taco agent tool list

列出本地 Agent DSL 已挂载工具。

G.1.1.8.3 taco agent tool remove

从本地 Agent DSL 移除已挂载工具。

G.1.1.9 taco agent validate

校验本地 Agent DSL 及可选分类模型契约。

G.1.2 taco aikb

发现并调用开发者中心 AIKB operation

子命令： call、operation

本级命令无专属参数。

G.1.2.1 taco aikb call

校验参数并执行 AIKB operation。

G.1.2.2 taco aikb operation

发现 AIKB operation

子命令： describe、list、search

本级命令无专属参数。

G.1.2.2.1 taco aikb operation describe

查看 operation 完整契约。

G.1.2.2.2 taco aikb operation list

列出 AIKB operation。

G.1.2.2.3 taco aikb operation search

按关键词搜索 AIKB operation。

G.1.3 taco app

应用管理

子命令： create、get、list、tag、template

本级命令无专属参数。

G.1.3.1 taco app create

创建指定模式的通用应用。

G.1.3.2 taco app get

按应用 ID 获取详情。

G.1.3.3 taco app list

分页列出应用并按名称、模式或标签过滤。

G.1.3.4 taco app tag

应用标签发现

子命令： list

本级命令无专属参数。

G.1.3.4.1 taco app tag list

列出应用标签并可按名称关键词过滤。

G.1.3.5 taco app template

应用模板发现与创建

子命令： create、list

本级命令无专属参数。

G.1.3.5.1 taco app template create

从应用模板创建远端应用。

G.1.3.5.2 taco app template list

列出当前企业可用的应用模板。

G.1.4 taco auth

认证管理

子命令： clear、connect、refresh、set-refresh-token、status

本级命令无专属参数。

G.1.4.1 taco auth clear

清理本地认证配置（默认当前 profile）。

G.1.4.2 taco auth connect

经 CLI Mgmt 校验并保存认证信息（推荐）。

G.1.4.3 taco auth refresh

刷新当前 profile 的 access token。

本级命令无专属参数。

G.1.4.4 taco auth set-refresh-token

保存 refresh token 与 Console API 地址。

G.1.4.5 taco auth status

查看当前 profile 的脱敏认证状态。

本级命令无专属参数。

G.1.5 taco category

智能体分类发现

子命令： get、list

本级命令无专属参数。

G.1.5.1 taco category get

按 code 获取分类，支持嵌套子分类。

G.1.5.2 taco category list

列出服务端当前配置的智能体分类树。

本级命令无专属参数。

G.1.6 taco chatflow

Chatflow（advanced-chat）本地 DSL 工具

子命令： apply、create、publish、run、stop、validate

本级命令无专属参数。

G.1.6.1 taco chatflow apply

预览或同步本地 Chatflow graph 到远端 draft。

G.1.6.2 taco chatflow create

创建远端 Chatflow 并初始化本地 YAML DSL。

G.1.6.3 taco chatflow publish

发布当前 Chatflow draft。

G.1.6.4 taco chatflow run

通过 SSE 调试远端 Chatflow draft。

G.1.6.5 taco chatflow stop

使用 task_id 停止 Chatflow draft 调试任务。

G.1.6.6 taco chatflow validate

校验 YAML DSL 并本地编译为 Dify graph。

G.1.7 taco credential

内置工具 Provider 凭据管理

子命令： delete、schema、set、status

本级命令无专属参数。

G.1.7.1 taco credential delete

删除租户共享的 Provider 凭据。

G.1.7.2 taco credential schema

读取 Provider 凭据字段定义，不读取值。

G.1.7.3 taco credential set

从 stdin 或环境变量设置 Provider 凭据。

G.1.7.4 taco credential status

读取凭据 schema 与服务端脱敏状态。

G.1.8 taco example

内置 DSL 示例发现

子命令： describe、list

本级命令无专属参数。

G.1.8.1 taco example describe

读取当前 CLI 内置的 DSL 示例。

G.1.8.2 taco example list

列出当前 CLI 内置的 DSL 示例。

G.1.9 taco help

以 text 或 JSON 输出当前 CLI 命令契约。

G.1.10 taco model

模型发现

子命令： describe、list

本级命令无专属参数。

G.1.10.1 taco model describe

获取模型详情及 completion 参数规则。

G.1.10.2 taco model list

列出 LLM，可按智能体分类过滤。

G.1.11 taco profile

管理 AccessKey 与旧 token profile

子命令： connect、list、remove、show、use

本级命令无专属参数。

G.1.11.1 taco profile connect

使用开发者中心 AccessKey 连接企业。

G.1.11.2 taco profile list

列出全部 profile。

本级命令无专属参数。

G.1.11.3 taco profile remove

删除一个 profile。

G.1.11.4 taco profile show

查看 profile 的脱敏配置。

G.1.11.5 taco profile use

切换当前 profile。

G.1.12 taco scenario

场景 playbook 发现

子命令： describe、list

本级命令无专属参数。

G.1.12.1 taco scenario describe

读取内置场景步骤与风险元数据。

G.1.12.2 taco scenario list

列出当前 CLI 内置的场景 playbook。

G.1.13 taco schema

读取当前 CLI 内置 DSL schema。

G.1.14 taco skills

Agent Skill 安装与状态

子命令： install、status

本级命令无专属参数。

G.1.14.1 taco skills install

安装或输出当前 wheel 内置的 taco Skill。

G.1.14.2 taco skills status

检查已安装 Skill 是否与当前 CLI 一致。

G.1.15 taco tool

内置工具发现

子命令： credentials、describe、list、provider

本级命令无专属参数。

G.1.15.1 taco tool credentials

内置工具 Provider 凭据管理

子命令： delete、schema、set、status

本级命令无专属参数。

G.1.15.1.1 taco tool credentials delete

删除租户共享的 Provider 凭据。

G.1.15.1.2 taco tool credentials schema

读取 Provider 凭据字段定义，不读取值。

G.1.15.1.3 taco tool credentials set

从 stdin 或环境变量设置 Provider 凭据。

G.1.15.1.4 taco tool credentials status

读取凭据 schema 与服务端脱敏状态。

G.1.15.2 taco tool describe

读取工具参数与 Provider 凭据 schema。

G.1.15.3 taco tool list

列出内置工具，可按 Provider 过滤。

G.1.15.4 taco tool provider

工具 Provider 发现

子命令： list

本级命令无专属参数。

G.1.15.4.1 taco tool provider list

列出 builtin/plugin 工具 Provider。

本级命令无专属参数。

G.1.16 taco workflow

HTTP Workflow 本地 DSL 工具

子命令： apply、create、publish、run、secret、stop、tool、validate

本级命令无专属参数。

G.1.16.1 taco workflow apply

预览或同步本地 Workflow graph 到远端 draft。

G.1.16.2 taco workflow create

创建远端 Workflow 并初始化本地 YAML DSL。

G.1.16.3 taco workflow publish

发布当前 Workflow draft。

G.1.16.4 taco workflow run

通过 SSE 调试远端 Workflow draft。

G.1.16.5 taco workflow secret

Workflow secret 管理

子命令： set

本级命令无专属参数。

G.1.16.5.1 taco workflow secret set

从环境变量设置远端 Workflow secret。

G.1.16.6 taco workflow stop

使用 task_id 停止 Workflow draft 调试任务。

G.1.16.7 taco workflow tool

Workflow Tool 发布、更新与查询

子命令： get、publish、update

本级命令无专属参数。

G.1.16.7.1 taco workflow tool get

按应用 ID 或 Tool ID 查询 Workflow Tool。

G.1.16.7.2 taco workflow tool publish

把已发布 Workflow 注册为 Tool；不会自动发布 Workflow。

G.1.16.7.3 taco workflow tool update

用本地 Workflow DSL 更新 Tool 配置；不会自动发布 Workflow。

G.1.16.8 taco workflow validate

校验 YAML DSL 并本地编译为 Dify graph。

G.2 核验方式

taco --version
taco help -o json
taco <一级命令> --help
taco <一级命令> <子命令> --help

本文附录用于统一查阅；实际执行时，以当前安装版本返回的帮助信息为准。