# @copado/agentia-cli 中文文档 规范地址：https://npmcn.com/package/%40copado/agentia-cli/ 版本：1\.6\.0 npm 元数据更新时间：2026-11-10T17:19:04.465Z 中文译文更新时间：2026-11-10T19:16:52.363Z 软件包许可：SEE LICENSE IN LICENSE\.md 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40copado/agentia-cli 原文对照：https://npmcn.com/package/%40copado/agentia-cli/?lang=original 项目主页：https://developer.copado.com/docs ## 关键信息（来自 npm 元数据） - 包体积（解压后）：22.8 MB，585 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=18\.0\.0 - 运行依赖：15 个 - 首次发布：2026-07-28T15:34:11.113Z - 最新版本发布：2026-11-10T17:19:04.209Z - 近 30 天下载量：3351（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：128（近 12 个月 128 个） ## 中文简介 Agricia 的命令行接口 ## 安装 ```sh npm install @copado/agentia-cli ``` 也可以使用：`pnpm add @copado/agentia-cli`、`yarn add @copado/agentia-cli`、`bun add @copado/agentia-cli` ## README # @copado/ agentia-cli (英语) Agentia 无头 Copado 工作流程的指令行界面(自动,环境,工作,管道,元数据,以及本地MCP). [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io/) [![Version](https://img.shields.io/npm/v/%40copado%2Fagentia-cli.svg)](https://www.npmjs.com/package/@copado/agentia-cli) [![Downloads/week](https://img.shields.io/npm/dw/%40copado%2Fagentia-cli.svg)](https://www.npmjs.com/package/@copado/agentia-cli) - [@copado/ agentia-cli (英语)](https://npmcn.com/package/%40copado/agentia-cli/#readme-copadoagentia-cli) - [使用量](https://npmcn.com/package/%40copado/agentia-cli/#readme-usage) - [本地 MCP 服务器](https://npmcn.com/package/%40copado/agentia-cli/#readme-local-mcp-server) - [本地质量门](https://npmcn.com/package/%40copado/agentia-cli/#readme-local-quality-gates) - [许可证](https://npmcn.com/package/%40copado/agentia-cli/#readme-license) - [图标](https://npmcn.com/package/%40copado/agentia-cli/#readme-commands) # 使用量 ```sh-session $ npm install -g @copado/agentia-cli@latest --registry https://registry.npmjs.org --@copado:registry=https://registry.npmjs.org $ agentia COMMAND running command... $ agentia (--version) @copado/agentia-cli/1.6.0 linux-x64 node-v22.23.4 $ agentia --help [COMMAND] USAGE $ agentia COMMAND ... ``` 代理检查npm `rc` 财务报告和审定财务报表 `latest` 在背景中,当安装的版本有新的版本时,警告。 自动选择使用选项 `updateChannel` 首选项 `~/.config/agentia-cli/config.json` (单位:千美元)`rc` 保持双通道比较,仍安装SemVer-Greater稳定; `latest` 仅稳定。 在没有偏好的情况下,预放装置会比较两个标记,并选择最新的SemVer,而稳定安装则只比较 `latest`运行 `agentia update` 安装选中的发布( 一个交互的 RC- 从稳定到稳定的交叉可以提示一次保存首选项; 在成功安装后警告运行 `setup skills update` 在使用Agtia管理技能的每个项目中, `agentia update --check` 在不更改安装或偏好的情况下检查,或 `agentia update --channel rc|latest` 以强制安装频道并保存该首选项。 RC是支持的预释通道;稳定的出版物使用npm的 `latest` dis. 在调用网关支持的命令前存储网关证书 : ```sh-session $ agentia auth set --cicd --region na $ agentia auth get ``` ## 在代理服务器后使用 Agricia Agentia在每次出局的HTTP(S)请求和CRT浏览器WebSocket连接上尊重标准代理环境变量,类似于Slesforce CLI: - `HTTPS_PROXY` 编号 : `https_proxy` tLS 流量( 建议) - `HTTP_PROXY` 编号 : `http_proxy` 用于普通 HTTP - `NO_PROXY` 编号 : `no_proxy` 用于必须直接连接的主机( comma- 分离; 支持) `*` 后缀通配符) - npm 风格 `npm_config_https_proxy`, (中文(简体) ), `npm_config_proxy`,以及 `npm_config_no_proxy` 当 CLI 在 npm 下运行时 循环目标`localhost`, (中文(简体) ), `127.0.0.1`, (中文(简体) ), `::1`)总是绕过代理,所以本地网关开发与IDE的收听者保持直接. ```sh-session $ export HTTPS_PROXY=http://proxy.example.com:3128 $ export NO_PROXY=localhost,127.0.0.1,.mycompany.com $ agentia cicd project list ``` 公司TLS检查可能需要信任你的组织CA. 设定 `NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem`,或使用 `NODE_USE_SYSTEM_CA=1` 在支持的节点版本上. 对于 Cursor 或 Claude 代码 MCP, 在 MCP 服务器中通过相同的变量 `env` 块,所以网关工具可以继承它们. NTLM 或 Kerberos 代理认证不构建; 使用本地转发代理服务器, 如 `px` 或者说 `cntlm` 给Agricia一个简单的HTTP代理. ## 读取用户故事 `agentia cicd work get --json` 返回 CICD 网关提供的完整用户记录 `result` 属性。 JSON反应保留了嵌入关系 `epic` 财务报告和审定财务报表 `feature` 记录; 人类输出在编辑时呈现相同的字段组 `oauthSignature`。通过 `--user-stories-ahead-behind` 还比较了在下一个管道环境之前和之后的用户故事,当故事有管道和源环境时. ```sh-session $ agentia cicd work get US-0001 --json $ agentia cicd work get US-0001 --user-stories-ahead-behind ``` ```json { "result": { "id": "a1Y000000000001EAA", "name": "US-0001", "title": "Improve deployment validation", "status": "Development In Progress", "project": "a0w000000000001AAA", "projectName": "Example Project", "pipelineId": "a0M000000000001EAA", "sourceEnvironment": "a0S000000000001EAA", "baseBranch": "main", "epic": {"id": "a0E000000000001EAA", "name": "EPIC-1", "title": "Example epic"}, "feature": {"id": "aDs000000000001EAA", "title": "Example feature"} }, "status": 0, "transactionId": "..." } ``` `cicd work create` 财务报告和审定财务报表 `cicd work update` 验证 `--acceptance-criteria` 本地:它必须包含少于255个字符. 对于Copado AI代理,存储AI PAT和组织上下文一次,然后使用 `ask` 用于脚本或 `chat` 互动会议: ```sh-session $ agentia auth set --ai --ai-domain robotic.copado.com --ai-org 42888 $ agentia ai agent ask --agent plan -p "Break this requirement into implementation steps" $ agentia ai agent ask --agent knowledge -p "Summarize the available workspace guidance" $ agentia ai agent chat --agent build --sf-org test14 --user-story US-1042 ``` ## 交互帮助和命令历史 用户可以在互动中直接打开实验性的多回合Copado支持对话 没有急切的 CCD 证书检查的终端 : ```sh-session $ agentia help-agent $ agentia support $ agentia help --agent ``` 在聊天中, Enter 提交提示和 Shift+ 输入新行. Help Agent 请求通过 CIDC 网关为每次转弯提供新的短寿命访问, 因此无效或 缺少 CIDC 证书无法解决问题, 而不是阻止聊天打开 。 每一个请求 添加 CLI 系统消息, 将助理识别为 Agentia Headless 上的简明 Copado 专家 和本地开发者的 Copado 工具。 回复符一到就写出. 在每一个 将 CLI 更新版本、 平台、 架构、 工作空间基名、 常态化的当前来源, 主要的CLI/IDE/MCP使用量是计数的,还有三项最新消毒的命令摘要。 工具或工具时 无法确定本地对云操作流量, 系统提示询问一个简短澄清 问. 每个命令摘要可以包含命令ID,正统来源,参数,时间戳, 持续时间、状态、退出代码、 CLI 版本、 工作空间基名、 已编辑的结构化结果, 以及 最后20个综合产出项目。 后续转折还包括确定性编辑的最多摘要 6个成功的信息,有固定的每个消息和总字节限制,而不是重发 无约束聊天历史 。 它从未发送完整的20个KiB日志,原始用户代理头,完整路径,证书, 符号、会话标识、请求机构或任意的未编辑错误. Agentia在业主-私人临时储存中最多保存了100个已消毒的执行摘要。 新记录 表示其来源为 `cli`, (中文(简体) ), `ide`,或 `mcp`;遗产记录可以省略. CLI 和 IDE 记录可以 包括经编辑的参数、结构化结果数据以及一个命令的、保留 最后20个 KiB 独立用于 stdout 和 stderr 。 MCP记录只包含命令ID,时间,结果, CLI 版本, 工作空间基名, 和源头—— 绝不是参数, 输出, 结果, 或错误 . 成功帮助 Agent turn coups 也存储在编辑后和每条消息切换后 4 KiB 私人临时JSONL。 此存储不恢复为以后的对话, 最多保留 100对,并采用滚动式24小时出入口. 检查命令摘要或清除两个仓库 改为: ```sh-session $ agentia history list --limit 10 $ agentia history list --limit 10 --json $ agentia history clear --yes ``` 里面的帮助特工, `/clear` 只重放记忆中的对话 . `agentia history clear --yes` 删除 两个临时历史文件。 运行时间/ 历史命令、 交互式 AI 聊天命令和帮助代理 入口仍然被排除在命令执行历史之外;MCP呼叫添加只使用元数据的条目. 没有提供MCP帮助代理或历史读取工具. 见 [交互式 AI 帮助代理](https://npmcn.com/package/%40copado/agentia-cli/docs/enablement/features/interactive-ai-help-agent.md) 对于先决条件, 隐私的细节,限制, 和解决问题. ## 代理技能设置 `agentia setup skills create` 安装可移植 Markdown 唯一的代理技能,教授兼容代理如何使用 Agentia CID(包括元数据探索), CRT测试, AI, 和管道高级命令正确, 外加特定目标路由文物(`.agents/skills/agentia/SKILL.md`, (中文(简体) ), `.cursor/rules/agentia.mdc`,或 `.claude/skills/agentia/SKILL.md`) (中文(简体) ). 使用 `--target agents` 页:1 `.agents/skills` (便携式默认), `--target cursor` 页:1 `.cursor/skills`,或 `--target claude` 页:1 `.claude/skills`设置不会修改客户根 `AGENTS.md`。 。 。 . ```sh-session $ agentia setup skills create --target agents $ agentia setup skills create --cicd --target cursor --no-prompt $ agentia setup skills update --ai --target agents --no-prompt ``` 使用 `update` 以刷新 Agentia 管理的技能文件。 无关文件被保存,没有Agentia管理标记的现有文件不会被覆盖,除非 `--force` 很明显. ### 插件技能 安装的插件可以通过一个 `agentia:contribute` 钩 (参见 [插件- sdk/ README. md](https://npmcn.com/package/%40copado/agentia-cli/plugin-sdk/README.md)) (中文(简体) ). 它们是第三方提示, 因此没有默认安装, 钩子只在您请求插件技能时运行: 交互式 `setup skills create`, (中文(简体) ), `--plugin`, (中文(简体) ), `setup skills list`,或 `setup skills update` 当插件技能已经安装时。 交互式 `setup skills create` 列出插件贡献( 无勾选) , 只安装您选择的插件; 无头运行和 `--json` 仅安装于 `--plugin`数字 : ```sh-session $ agentia setup skills list $ agentia setup skills create # pick plugin skills in the prompt $ agentia setup skills create --plugin @acme/agentia-plugin-release --target cursor --no-prompt $ agentia setup skills update ``` 以 id 身份贡献的技能 `release` 安装为 `agentia-release`。 。 。 . `setup skills list` 显示可安装的技能,以及为什么一个无效的插件被跳过;一个失败或慢的插件从不屏蔽其他的,一个没有钩子的插件会被忽略。 与 `--plugin` 并且没有只写包旗插件技能;否则生成的 Agentia 规则文件会为每个已安装的插件技能获得"Plugin 技能"一行. 插件技能带有每个插件管理的标记; 未经管理或由另一个插件拥有的文件永远不会被替换 `--force`。 。 。 . `setup skills update` 没有旗帜的插件也刷新了项目中已有的插件技能,并在插件未安装或不再贡献时警告. 除非您运行, 否则不会删除 `agentia setup skills update --prune`,它只删除那些带有插件所管理标记的文件(从未标记过文件、符号链接或其他插件文件),从规则文件中去掉它们的行,并被跳过,用于任何钩子失败或超时的插件。 贡献如果列出非马克当文件,符号链接,插件外的路径,则被拒绝, `allowed-tools`,保留或复制的 id,不支持 `apiVersion`,或者超过50个文件,每个文件256个KiB,或者每个技能1个MiB. 撰稿人设置、本地网关模式和集成测试记录于 [发展.md](https://npmcn.com/package/%40copado/agentia-cli/DEVELOPMENT.md)。 。 。 . # 本地 MCP 服务器 Agentia可以作为本地的模型上下文协议(MCP)服务器运行于stdio上. Cursor等与MCP相容的客户端然后可以在不使用终端的情况下调用Agentia工具. ## 先决条件 1. 安装 CLI 这样 `agentia` 可用时间 : ```sh-session $ npm install -g @copado/agentia-cli@rc --registry https://registry.npmjs.org --@copado:registry=https://registry.npmjs.org ``` 2. 存储证书. MCP 服务器重用与 CLI 相同的密钥链后置认证 : ```sh-session $ agentia auth set --cicd --region na $ agentia auth set --ai --ai-domain robotic.copado.com --ai-org 42888 $ agentia auth get ``` 3. 确认 MCP 命令可用 : ```sh-session $ agentia mcp --help $ agentia mcp start --help ``` ## 启动服务器 ```sh-session $ agentia mcp start ``` 此指相为长. 它会讲MCP 超过stdio 并等待客户端连接。 启动后不要期待交互式终端输出 . ## 配置光标 添加一个发射 Agentia 的 MCP 服务器条目 : ```json { "mcpServers": { "agentia": { "type": "stdio", "command": "agentia", "args": ["mcp", "start"], "env": { "AGENTIA_PROJECT_ROOT": "${workspaceFolder}" } } } } ``` 这不管用 `.cursor/mcp.json` 或全球 `~/.cursor/mcp.json`: 光标扩展 `${workspaceFolder}` 用于活动的工作空间,所以 Agentia 加载存储器的 `.agentia` 默认、 项目认证和 `.env`。保存配置后,在 Cursor 中重新装入 MCP 服务器. ## 配置 Claude 代码 `agentia setup` 可以写入工程 `.mcp.json` 输入 Claude 代码并预先批准 `agentia` 服务器在 `.claude/settings.local.json`。推荐条目将克劳德的项目目录通过Agricia: ```json { "mcpServers": { "agentia": { "type": "stdio", "command": "agentia", "args": ["mcp", "start"], "env": { "AGENTIA_PROJECT_ROOT": "${CLAUDE_PROJECT_DIR:-}" } } } } ``` Claude 代码扩展 `CLAUDE_PROJECT_DIR` 用于本地 stdio 服务器。 若为 `AGENTIA_PROJECT_ROOT` 或者说 `CLAUDE_PROJECT_DIR` 空的或仍然是未扩展的占位符(例如) `${CLAUDE_PROJECT_DIR:-}`),Agentia忽略了它,并倒回了MCP客户端所报的文件夹,再向上走去取项目标记. 您也可以手动添加 Agricia `claude mcp add` 或一个 `mcpServers` 输入 `~/.claude.json`。 。 。 . 用于当地其他MCP客户,设置 `AGENTIA_PROJECT_ROOT` 改为绝对工程目录。 当不存在明确的根时,Agentia在可用时使用一个本地的MCP根,否则从它的启动目录上向上搜索. 需要多个本地根 `AGENTIA_PROJECT_ROOT` 以避免选择错误的项目. 可选最终覆盖: set `AGENTIA_MCP_PROJECT_ROOT` 到 MCP 服务器上的绝对工程目录 `env`。设定时, Agentia 使用该路径作为默认的工程根、 认证配置文件以及 `.env` 装入,而不使用客户端的 `roots/list` 项目选择结果. ## 请求身份 识别网关请求 **什麽** 跑进去了 `Referer` 财务报告和审定财务报表 **怎么样** 它跑进来了 `User-Agent` 财务报告和审定财务报表 `event-source`。 。 。 . - 贝壳CLI: `Referer` 是 oclif 命令 id (例如 `cicd:environment:list`) (中文(简体) ). `User-Agent` 实值 `agentia-cli/` 财务报告和审定财务报表 `event-source` 实值 `agentia-cli`。 。 。 . - MCP: 将 CLI 命令包裹起来的工具, 发送与 ID 相同的命令 `Referer`。 。 。 . `User-Agent` 实值 `agentia-mcp/` 财务报告和审定财务报表 `event-source` 实值 `agentia-mcp`。只使用 MCP 的帮助者将其 MCP 工具 ID 保留为 `Referer`。 。 。 . - IDE: 设置 `AGENTIA_CLIENT_ORIGIN=ide` 当IDE扩展产出Agentia时,包括 `agentia mcp start`,并通过扩展版本为 `AGENTIA_IDE_VERSION`。一个有效的 IDE 版本生成 `User-Agent: agentia-ide/ (agentia-cli/)`; 缺少或无效的值返回到 `agentia-ide/`。 。 。 . `event-source` 遗 物 `agentia-ide`。不支持的源值和 IDE 版本被忽略. ## 可用工具 工具是JSON安全并返回结构化的结果。 敏感字段被编辑 . | 专题 | 工具 | | --- | --- | | 大赦国际 | `agentia_ai_ask` | | 认证 | `agentia_auth_get`, (中文(简体) ), `agentia_auth_set` | | 自动 | `agentia_adv_auth_status`, (中文(简体) ), `agentia_adv_organization_list`, (中文(简体) ), `agentia_adv_organization_get`, (中文(简体) ), `agentia_adv_organization_validate`, (中文(简体) ), `agentia_adv_deployment_list`, (中文(简体) ), `agentia_adv_deployment_get`, (中文(简体) ), `agentia_adv_deployment_create`, (中文(简体) ), `agentia_adv_deployment_options`, (中文(简体) ), `agentia_adv_deployment_validate`, (中文(简体) ), `agentia_adv_deployment_deploy`, (中文(简体) ), `agentia_adv_deployment_quick_deploy`, (中文(简体) ), `agentia_adv_deployment_cancel`, (中文(简体) ), `agentia_adv_component_types`, (中文(简体) ), `agentia_adv_component_list`, (中文(简体) ), `agentia_adv_component_refresh`, (中文(简体) ), `agentia_adv_component_selected`, (中文(简体) ), `agentia_adv_component_add`, (中文(简体) ), `agentia_adv_component_remove`, (中文(简体) ), `agentia_adv_job_get`, (中文(简体) ), `agentia_adv_job_list`, (中文(简体) ), `agentia_adv_job_wait` | | 证书 | `agentia_credential_list`, (中文(简体) ), `agentia_credential_create`, (中文(简体) ), `agentia_credential_update`, (中文(简体) ), `agentia_credential_auth_status` | | 数据 | `agentia_data_template_list`, (中文(简体) ), `agentia_data_template_get`, (中文(简体) ), `agentia_data_template_get_detail`, (中文(简体) ), `agentia_data_template_create`, (中文(简体) ), `agentia_data_template_save_detail`, (中文(简体) ), `agentia_data_template_delete`, (中文(简体) ), `agentia_data_template_convert_old`, (中文(简体) ), `agentia_data_records_search`, (中文(简体) ), `agentia_data_records_match`, (中文(简体) ), `agentia_data_commit_create`, (中文(简体) ), `agentia_data_commit_list`, (中文(简体) ), `agentia_data_dataset_file_list`, (中文(简体) ), `agentia_data_dataset_file_content`, (中文(简体) ), `agentia_data_filter_list`, (中文(简体) ), `agentia_data_filter_add`, (中文(简体) ), `agentia_data_filter_update`, (中文(简体) ), `agentia_data_filter_delete`, (中文(简体) ), `agentia_data_formula_list`, (中文(简体) ), `agentia_data_formula_create`, (中文(简体) ), `agentia_data_formula_update`, (中文(简体) ), `agentia_data_sobject_fields`, (中文(简体) ), `agentia_data_sobject_relationships`, (中文(简体) ), `agentia_data_sync_apply`, (中文(简体) ), `agentia_data_sync_preview_updates` | | 环境 | `agentia_environment_list`, (中文(简体) ), `agentia_environment_get`, (中文(简体) ), `agentia_environment_create`, (中文(简体) ), `agentia_environment_update`, (中文(简体) ), `agentia_environment_auth_status` | | 函数 | `agentia_function_list`, (中文(简体) ), `agentia_function_get`, (中文(简体) ), `agentia_function_defaults`, (中文(简体) ), `agentia_function_upsert`, (中文(简体) ), `agentia_function_delete`, (中文(简体) ), `agentia_function_run`, (中文(简体) ), `agentia_function_run_local`, (中文(简体) ), `agentia_function_result_get`, (中文(简体) ), `agentia_function_result_log_get` | | 任务模板 | `agentia_template_list`, (中文(简体) ), `agentia_template_get`, (中文(简体) ), `agentia_template_defaults`, (中文(简体) ), `agentia_template_upsert`, (中文(简体) ), `agentia_template_delete` | | 施政 | `agentia_health_check` | | 任务 | `agentia_job_list`, (中文(简体) ), `agentia_job_get`, (中文(简体) ), `agentia_job_log_get`, (中文(简体) ), `agentia_job_run`, (中文(简体) ), `agentia_job_resume`, (中文(简体) ), `agentia_job_kill`, (中文(简体) ), `agentia_job_pause` | | 管道 | `agentia_pipeline_list`, (中文(简体) ), `agentia_pipeline_get`, (中文(简体) ), `agentia_pipeline_create`, (中文(简体) ), `agentia_pipeline_update`, (中文(简体) ), `agentia_pipeline_connection_list`, (中文(简体) ), `agentia_pipeline_connection_create`, (中文(简体) ), `agentia_pipeline_connection_update`, (中文(简体) ), `agentia_pipeline_connection_delete`, (中文(简体) ), `agentia_pipeline_stage_connection_list`, (中文(简体) ), `agentia_pipeline_stage_connection_create`, (中文(简体) ), `agentia_pipeline_stage_connection_update`, (中文(简体) ), `agentia_pipeline_stage_connection_delete`, (中文(简体) ), `agentia_pipeline_automation_list`, (中文(简体) ), `agentia_pipeline_automation_get`, (中文(简体) ), `agentia_pipeline_automation_create`, (中文(简体) ), `agentia_pipeline_automation_update`, (中文(简体) ), `agentia_pipeline_automation_delete`, (中文(简体) ), `agentia_pipeline_automation_activate`, (中文(简体) ), `agentia_pipeline_automation_deactivate`, (中文(简体) ), `agentia_pipeline_quality_gate_list`, (中文(简体) ), `agentia_pipeline_quality_gate_get`, (中文(简体) ), `agentia_pipeline_quality_gate_create`, (中文(简体) ), `agentia_pipeline_quality_gate_update`, (中文(简体) ), `agentia_pipeline_quality_gate_delete`, (中文(简体) ), `agentia_pipeline_quality_gate_activate`, (中文(简体) ), `agentia_pipeline_quality_gate_deactivate`, (中文(简体) ), `agentia_extension_configuration_list`, (中文(简体) ), `agentia_extension_configuration_get` | | 阶段 | `agentia_stage_list`, (中文(简体) ), `agentia_stage_get`, (中文(简体) ), `agentia_stage_create`, (中文(简体) ), `agentia_stage_update`, (中文(简体) ), `agentia_stage_delete` | | 项目 | `agentia_project_list`, (中文(简体) ), `agentia_project_get`, (中文(简体) ), `agentia_project_create`, (中文(简体) ), `agentia_project_update`, (中文(简体) ), `agentia_project_delete`, (中文(简体) ), `agentia_project_default_get`, (中文(简体) ), `agentia_project_default_set`, (中文(简体) ), `agentia_project_default_unset` | | 仓库 | `agentia_repository_list`, (中文(简体) ), `agentia_repository_get`, (中文(简体) ), `agentia_repository_create`, (中文(简体) ), `agentia_repository_update`, (中文(简体) ), `agentia_repository_delete`, (中文(简体) ), `agentia_repository_reset`, (中文(简体) ), `agentia_repository_validate` | | 晋升 | `agentia_promotion_list`, (中文(简体) ), `agentia_promotion_get`, (中文(简体) ), `agentia_promotion_run`, (中文(简体) ), `agentia_promotion_job_step_update`, (中文(简体) ), `agentia_promotion_queue_list`, (中文(简体) ), `agentia_promotion_queue_remove`, (中文(简体) ), `agentia_promotion_conflict_list`, (中文(简体) ), `agentia_promotion_conflict_get`, (中文(简体) ), `agentia_promotion_conflict_resolve`, (中文(简体) ), `agentia_promotion_conflict_unresolve` | | 用户 | `agentia_user_get` | | 工作 | `agentia_work_list`, (中文(简体) ), `agentia_work_get`, (中文(简体) ), `agentia_work_create`, (中文(简体) ), `agentia_work_update`, (中文(简体) ), `agentia_work_delete`, (中文(简体) ), `agentia_work_deployment_step_types`, (中文(简体) ), `agentia_work_deployment_step_salesforce_flows`, (中文(简体) ), `agentia_work_deployment_step_list`, (中文(简体) ), `agentia_work_deployment_step_create`, (中文(简体) ), `agentia_work_deployment_step_update`, (中文(简体) ), `agentia_work_deployment_step_reorder`, (中文(简体) ), `agentia_work_deployment_step_delete`, (中文(简体) ), `agentia_work_set`, (中文(简体) ), `agentia_work_status`, (中文(简体) ), `agentia_work_publish`, (中文(简体) ), `agentia_work_push`, (中文(简体) ), `agentia_work_test`, (中文(简体) ), `agentia_work_test_apex`, (中文(简体) ), `agentia_work_submit`, (中文(简体) ), `agentia_work_done` | | 云头 | `agentia_cloud_commit`, (中文(简体) ), `agentia_cloud_promote` (单位:千美元)`agentia_work_commit` 仍为兼容性别名 `agentia_cloud_commit`(中文(简体) ) | | 元数据 | `agentia_metadata_list`, (中文(简体) ), `agentia_metadata_explore`, (中文(简体) ), `agentia_metadata_content_get`, (中文(简体) ), `agentia_metadata_content_compare`, (中文(简体) ), `agentia_metadata_index_compare`, (中文(简体) ), `agentia_metadata_dependency_list`, (中文(简体) ), `agentia_metadata_refresh_run`, (中文(简体) ), `agentia_metadata_refresh_status`, (中文(简体) ), `agentia_metadata_refresh_deleted` | | 通知 | `agentia_notification_configure`, (中文(简体) ), `agentia_notification_get` | | 测试 | `agentia_testing_project_list`, (中文(简体) ), `agentia_testing_project_get`, (中文(简体) ), `agentia_testing_project_create`, (中文(简体) ), `agentia_testing_project_update`, (中文(简体) ), `agentia_testing_project_delete`, (中文(简体) ), `agentia_testing_project_permission_list`, (中文(简体) ), `agentia_testing_project_permission_get`, (中文(简体) ), `agentia_testing_project_permission_set`, (中文(简体) ), `agentia_testing_project_permission_update`, (中文(简体) ), `agentia_testing_robot_list`, (中文(简体) ), `agentia_testing_robot_get`, (中文(简体) ), `agentia_testing_robot_create`, (中文(简体) ), `agentia_testing_robot_update`, (中文(简体) ), `agentia_testing_robot_delete`, (中文(简体) ), `agentia_testing_job_list`, (中文(简体) ), `agentia_testing_job_get`, (中文(简体) ), `agentia_testing_job_create`, (中文(简体) ), `agentia_testing_job_run`, (中文(简体) ), `agentia_testing_job_update`, (中文(简体) ), `agentia_testing_job_delete`, (中文(简体) ), `agentia_testing_job_refs`, (中文(简体) ), `agentia_testing_job_files_list`, (中文(简体) ), `agentia_testing_job_files_upload`, (中文(简体) ), `agentia_testing_job_files_download`, (中文(简体) ), `agentia_testing_job_runs_list`, (中文(简体) ), `agentia_testing_job_runs_get`, (中文(简体) ), `agentia_testing_job_runs_search`, (中文(简体) ), `agentia_testing_job_runs_logs`, (中文(简体) ), `agentia_testing_job_runs_abort`, (中文(简体) ), `agentia_testing_job_schedule_get`, (中文(简体) ), `agentia_testing_job_schedule_set`, (中文(简体) ), `agentia_testing_job_schedule_remove`, (中文(简体) ), `agentia_testing_data_table_list`, (中文(简体) ), `agentia_testing_data_table_get`, (中文(简体) ), `agentia_testing_data_table_create`, (中文(简体) ), `agentia_testing_data_table_update`, (中文(简体) ), `agentia_testing_data_table_delete`, (中文(简体) ), `agentia_testing_variable_list`, (中文(简体) ), `agentia_testing_variable_get`, (中文(简体) ), `agentia_testing_variable_create`, (中文(简体) ), `agentia_testing_variable_update`, (中文(简体) ), `agentia_testing_variable_delete`, (中文(简体) ), `agentia_testing_user_parameter_list`, (中文(简体) ), `agentia_testing_user_parameter_get`, (中文(简体) ), `agentia_testing_user_parameter_create`, (中文(简体) ), `agentia_testing_user_parameter_update`, (中文(简体) ), `agentia_testing_user_parameter_delete`, (中文(简体) ), `agentia_testing_browser_start`, (中文(简体) ), `agentia_testing_browser_stop`, (中文(简体) ), `agentia_testing_browser_status`, (中文(简体) ), `agentia_testing_browser_execute`, (中文(简体) ), `agentia_testing_browser_inspect`, (中文(简体) ), `agentia_testing_browser_screenshot`, (中文(简体) ), `agentia_testing_browser_set_options`, (中文(简体) ), `agentia_testing_browser_history` | ### 通用工具说明 - `agentia_work_set`, (中文(简体) ), `agentia_work_publish`,以及 `agentia_work_submit` 运行在 MCP 服务器进程当前工作目录中的 Git 寄存器上. 他们可以检查一个树枝, 从,推到 `origin`; 从预定仓库启动服务器。 若为 `agentia_work_set` 返回时 `status: "warning"`,它打印了网关消息,没有运行 git 或更新本地工作环境。 工作集抓取基分行,当该参考文献存在时,远程功能分行,然后创建或检查退出 `feature/` 从远程特性当存在, 否则从基部。 工作集还将 Copado 故事源证书与 CIDC 项目默认在工作/设置响应后进行比较:当故事证书缺失时,它会发出警告,当绑定的故事没有项目默认时会跳过比较,当故事不同时会发出警告而不改变故事(当前证书和环境显示;使用) `agentia_work_update` 编号 : `cicd work update --source-credential` 以改变它. - `agentia_ai_ask` 镜像 `agentia ai agent ask --json`: 它会缓冲代理响应, 返回结构化的警告/ 跟踪/ 链接, 并且永远不会返回隐藏的推理块 。 计划、构建和测试请求接受 `credentialId`, (中文(简体) ), `forceCredentialSync`,以及 `noCredentialSync` 以控制工程默认 Copado 证书同步,加 `sfOrg` 仅作为快捷的背景. - 基于浏览器 `cicd environment auth web login` 仍然是只使用CLI的指令. - 管道和工作工具需要 `userId` 财务报告和审定财务报表 `organizationId` 用于网关 `x-user-id` 财务报告和审定财务报表 `x-organization-id` 头. - 任务列表接受诸如 `status`, (中文(简体) ), `name`, (中文(简体) ), `type`, (中文(简体) ), `parent`, (中文(简体) ), `context`,以及 `limit`。 。 。 . - 元数据工具需要与 CLI 旗帜相同的网关标识符, 例如 `pipelineId`, (中文(简体) ), `sourceOrgId`,以及 `sourceCredentialId` 在适用的情况下. - 项目列表接受可选 `mine` 将结果限制在目前用户拥有或相关的项目. - 由本地或全局默认管理的项目默认工具 `agentia cicd project default *`。 。 。 . - 用户获得默认值 `id` 改为 `me` 用于认证用户. - 环境创建/更新工具映射相应的 CLI 命令, 只发送您提供的字段 . - 工作设置/ 打印/ 提交/ done 工具镜像 CLI 工作流程 : `set` 准备 `feature/`,则 `publish` 编号 : `submit` 编号 : `done` 在当前特征分支上运行,具有相同的清洁树和基干要求. `agentia_work_push` 仍为兼容性别名 `agentia_work_publish`。 。 。 . - `agentia_cloud_commit` 需求 `metadataCategory` 用于简单的输入,每个 `changes` 需要输入 `c` (或 `category`) (中文(简体) ). 销售力量元数据集 `SFDX`。 Copado SFDX 部署将更改的行按该字段进行分类;省略其日志“未找到的销售量更改”并跳过部署. - 工作部署步骤工具镜像 `cicd work deployment-step *`; 创建接受已解析的内置 `configJson` 或与 CLI 相同的特定类型引导字段,更新使用 `null` 以清除已失效的字段,重新排序需要完成 `before` 财务报告和审定财务报表 `after` ID阵列. - 升级列表接受与 `agentia cicd promotion list`; 升迁取取升迁身份证. `agentia_promotion_job_step_update` 镜像 `cicd promotion job-step update`,验证稀有的手动任务更新,并裁剪受让人值. `agentia_promotion_run` 财务报告和审定财务报表 `agentia_cloud_promote` 重新使用CLI的飞行前,运行/恢复,命令部署步骤,以及限制投票行为. `agentia_cloud_promote` 并自动创建前置 Draft 推广, 当没有包含 User Story 并返回可选 `createdPromotion` 在结果. - `agentia_notification_configure` 镜像 `agentia cicd notification configure`: 当前用户的管道上只使用黑字订阅. 解决管道问题 已经 `agentia_pipeline_get` 先说 需要所有字段`pipelineId`, (中文(简体) ), `event`, (中文(简体) ), `destinationType`, (中文(简体) ), `destinationId`, (中文(简体) ), `subscription`) (中文(简体) ). 带有空格的事件名称使用与 CLI 相同的下划线符号( 例如 ) `Test_Not Started`) (中文(简体) ). - `agentia_notification_get` 镜像 `agentia cicd notification get`: 需要 `pipelineId` 返回时进行消毒 `{ pipelineId, subscriptions }` 用于认证的用户(没有原始的系统财产元数据). ## CRT 网络 Git 辅助工作 使用 Git 存储, 当 CRT 应当从仓库分支获取 Robot Framework 文件, 而不是将本地文件上传到快照工作 . ```sh agentia testing job create \ --project 112901 \ --robot 123456 \ --name "Login smoke from Git" \ --git-url https://github.com/acme/crt-tests.git \ --git-branch feature/login-smoke ``` 对于私人寄存器,更喜欢CRT域证书: ```sh agentia testing job create \ --project 112901 \ --robot 123456 \ --name "Login smoke from Git" \ --git-url http ``` ## 常见问题 ### @copado/agentia-cli 是什么？ Agricia 的命令行接口 ### 如何安装 @copado/agentia-cli？ 在项目目录运行 npm install @copado/agentia-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentia，可以用 npx agentia 直接运行。 ### @copado/agentia-cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/copado\_\_agentia-cli 是否存在。 ### @copado/agentia-cli 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @copado/agentia-cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @copado/agentia-cli 可以商用吗？ @copado/agentia-cli 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。 ### @copado/agentia-cli 的下载量有多少？ 根据 npm 官方下载统计，@copado/agentia-cli 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,351 次，日均约 112 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @copado/agentia-cli 还在维护吗？ 最新版本 1\.6\.0 发布于 2026/11/11（今天）；至今共发布 128 个版本，其中过去 12 个月发布了 128 个；首次发布于 2026/07/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。