选择 AI 助手
先按 快速开始 准备好卷王连接地址和专用 Token,再按你使用的助手完成安装。
| AI 助手 | 下载技能包 | 操作指南 |
|---|---|---|
| WorkBuddy | WorkBuddy 专用包 | 跟着截图安装和连接 |
| Codex | 通用技能包 | Codex 步骤 |
| TraeWork | 通用技能包 | TraeWork 步骤 |
当前技能包版本为 1.1.0。填写连接设置时,使用自己的卷王地址和 Token,保留已有的其他连接。
WorkBuddy
按 WorkBuddy 图文上手 完成以下步骤:
- 在「技能 → 添加技能 → 上传技能」导入专用 ZIP,并启用
surveyking。 - 在「连接器 → 自定义连接器 → 添加 MCP」填写连接地址和 Token。
- 保存后点击「信任」,等待连接成功,再新建任务。
Codex
安装技能
下载 通用技能包,将包内全部内容解压到 ~/.agents/skills/surveyking/,目录内应直接有 SKILL.md。安装后重新打开 Codex。
只想在某个项目使用时,也可以放到该项目的 .agents/skills/surveyking/。
填写连接设置
在 ~/.codex/config.toml 中添加下面的内容,将示例地址换成自己的卷王连接地址。已有 surveyking 连接时,更新对应内容:
[mcp_servers.surveyking]
url = "https://你的卷王域名/open-api/agent/mcp"
bearer_token_env_var = "SURVEYKING_API_TOKEN"
startup_timeout_sec = 70
tool_timeout_sec = 130
接着在本机设置 Token,让 Codex 启动时能够读取它。下面以 macOS 命令行版为例:
read -rs 'SURVEYKING_API_TOKEN?请输入卷王专用 Token:'
export SURVEYKING_API_TOKEN
codex
在提示处输入 Token,再启动 Codex;输入时不会显示明文。使用 Bash 时,第一行改为 read -rs -p '请输入卷王专用 Token:' SURVEYKING_API_TOKEN。
桌面版也需要在启动时能读取上述 Token。在另一个终端里设置后,已经打开的应用不会自动获得它,相关处理见 常见问题。客户端自己的设置说明见 Codex 官方指南。
开始对话
在新任务中发送:
$surveyking 帮我创建一份个人信息问卷,先保存草稿,给我编辑链接。
打开返回的卷王链接,检查题目和草稿状态。
TraeWork
安装技能
下载 通用技能包,在技能上传入口选择 ZIP 并启用 surveyking。
填写连接设置
打开 设置 → MCP → 创建 → 手动配置,复制下面的内容,将地址和 Token 换成自己的值,其他内容保持不变:
{
"mcpServers": {
"surveyking": {
"url": "https://你的卷王域名/open-api/agent/mcp",
"headers": {
"Authorization": "Bearer <在这里填写卷王专用 Token>",
"START_MCP_TIMEOUT_MS": "70000",
"RUN_MCP_TIMEOUT_MS": "130000"
}
}
}
}
保存并启用连接。如果卷王部署在公司内网,选择能打开该站点的本地桌面环境。
开始对话
新建任务,发送:
使用 surveyking 技能,帮我创建一份个人信息问卷,先保存草稿,给我编辑链接。
Cursor、VS Code 等其他助手
在卷王 个人中心 → 智能体接入 → 连接配置 中选择对应助手,复制配置,再按助手的连接设置要求填写 Token。
安装技能的位置和授权填写方式可能不同,请按所用助手的说明完成设置。
怎样确认已经可以使用
助手应返回实际保存的问卷链接。打开链接后,能在卷王里看到题目和草稿状态,就说明这次创建已经完成。
如果只能描述如何创建,或没有返回可打开的链接,请按 常见问题 检查连接和授权。