Agent 集成
LinkAI CLI 让 任意 Agent / Coding 工具 都能把 LinkAI 平台当作基础设施来调用——对话、检索知识库、查询数据库、运行工作流、执行插件、生成图片 / 视频 / 语音等。装好 CLI 后，Agent 通过内置的 Skill 即可了解如何驱动它，无需额外配置。
Agent Skill 是什么
Skill 是一份面向 Agent 的使用说明（skills/linkai-cli/），描述了每个命令的用途、参数、JSON 输出结构与调用建议。一键安装脚本会把 Skill 安装到常见 AI 工具的目录中：
- Claude Code
- Cursor
- Codex
- CowAgent
- OpenClaw
- 以及其他兼容 Skill 机制的工具
安装后，这些工具在需要 LinkAI 能力时会自动读取 Skill，按其中的约定调用 linkai 命令。
让 Agent 自行安装
最简单的方式是把下面这句话发给 Agent，它会自行安装 CLI、下载 Skill 并开始使用：
阅读 https://cdn.link-ai.tech/cli/install.md 并按其中的步骤安装 CLI 与 Skill，然后开始使用。
Agent 调用约定
Skill 中对 Agent 调用做了如下约定，便于自动化与结果解析：
| 场景 | 约定 | 原因 |
|---|---|---|
| 输出 | 追加 --json | 结果可被程序解析 |
对话 chat | 管道输出时自动非流式，或显式加 --no-stream | 一次性拿到完整回复 |
删除 knowledge delete | 加 --force | 跳过交互确认 |
登录 auth login | 使用两步式设备码流程 | 授权需用户在浏览器完成 |
长任务 video gen | 内置轮询，等待即可 | 无需重复轮询 |
| 未知命令 / 参数 | 运行 linkai <命令> --help | --help 是最权威的参数来源 |
典型调用流程
- 确认登录：会话首次调用前先执行
linkai auth status --json，若非valid则走登录流程。 - 选择命令：根据意图选定对应命令（对话 / 知识库 / 数据库 / 工作流 / 插件 / 内容生成）。
- 解析资源编码：先用
list --json拿到app_code/kb_code/db_code/plugin_code，不要凭空猜测编码。 - 执行并解析：加
--json调用，解析结果，只向用户呈现所需信息。 - 处理错误：非零退出时按退出码分类；遇到权限错误（退出码
3）应停止并请用户重新登录申请对应权限，而不是重试。
登录（Agent 流程）
登录需要用户在浏览器中授权，因此 Agent 使用两步式设备码流程，避免阻塞：
# 第 1 步：获取授权链接，发给用户去浏览器授权
linkai auth login --no-wait --json
# 第 2 步：轮询直到用户完成授权（每次调用最多阻塞 --wait 秒）
linkai auth login --device-code <code> --wait 60 --json
当返回的 event 为 authorization_pending 时重复第 2 步；authorization_complete 表示登录成功，authorization_failed 表示需从第 1 步重新开始。设备码约 5 分钟过期。
权限恢复
默认登录不包含 db:write、knowledge:update、knowledge:delete 等敏感权限。当某命令因权限不足失败（退出码 3）且用户同意时，重新登录并追加对应 --scope：
linkai auth login --scope "<原有权限> <缺失的权限>"
完整权限列表见 命令参考 - 权限。