AI 获客智能体使用说明
1. 开始使用
1.1 产品介绍
HeyCivis（AI 获客智能体 / AI SDR Agent）是一款运行在用户电脑上的全自动获客机器人。HeyCivis 使用用户自己的 LinkedIn 账号，在 LinkedIn 上自动寻找潜在客户，完成背景调查、匹配筛选、好友申请、个性化触达和持续跟进，并在客户产生兴趣后引导其预约会议，为销售团队持续交付高质量商机。客户资料、对话记录和跟进进度保存在用户自己的电脑上，不会上传到服务器，卸载应用时默认保留这些数据。
1.2 快速开始
首次使用只需完成以下 6 步，每步的详细说明见对应小节。
系统要求
- Windows（64 位）；
- 运行需要能够访问 LinkedIn、AI 模型服务和 HeyCivis 账户服务；启用邮箱查询时，还需访问邮箱查询服务。
第 1 步：下载并安装
安装包为 HeyCivis-Setup.zip，从 HeyCivis 官网获取（购买或申请试用后提供下载）。
- 双击
HeyCivis-Setup.exe； - 按提示完成安装。默认安装到当前用户的程序目录，无需管理员权限；
- 安装完成后自动生成桌面和开始菜单快捷方式，并部署内置的 Agent Skill、执行一次安装自检。
首次启动时，客户端会按需准备运行所需的浏览器组件。
第 2 步：注册并登录 HeyCivis 账户
使用邮箱和密码注册账户，或直接使用已有账户登录。注册和登录都需要同意用户协议与隐私政策，并完成人机验证；注册成功后自动登录。
账户需要有可用余额或任意有效订阅，机器人才能启动。详见「2.1 账户与 AI 模型」。
第 3 步：绑定 LinkedIn 账号
在「2.2 LinkedIn 账号与每日额度」中填写 LinkedIn 邮箱和密码。
先将 LinkedIn 界面语言切换为 English，否则机器人可能无法识别页面并正常操作。
第 4 步：配置 AI 模型
在「2.1 账户与 AI 模型」中填写服务商、模型名称和 API key；OpenAI 兼容服务还需填写 API base。使用内置 HeyCivis 模型时无需填写 API key。
第 5 步：创建首个项目
在「3.1 新建项目」中创建项目，填写：
- 业务介绍：说明产品、目标客户、解决的问题和核心价值；
- 获客目标：说明找谁、如何筛选、聊什么以及如何推进。
这两段文字同时驱动搜索词生成、AI 客户筛选和跟进话术，写法详见「3 项目」。
第 6 步：启动机器人
在任务页点击“启动”，机器人会在工作时段内自动开始搜索和筛选客户，执行情况在「4 运营」查看。启动与停止的详细说明见「1.3 启动、停止与窗口行为」。
1.3 启动、停止与窗口行为
启动
缺少执行账号、AI 模型或项目时，任务页会显示“初始化”；完成配置后才显示“启动”。
确认页面顶部的 LinkedIn 账号、工作时区和活跃时段正确后，点击“启动”。页面状态会随机器人运行自动刷新；需要立即查看最新状态时，通过托盘菜单的“同步”手动刷新。
停止
需要暂停时，在任务页点击“停止”。
关窗口不等于退出
- 点击窗口右上角的关闭按钮，应用会隐藏到系统托盘，机器人继续运行；
- 需要完全退出应用时，使用托盘菜单中的“退出”。
启动后在哪里看结果
- 任务页：当天已使用的连接和跟进额度、三类任务及其状态；
- 项目页：客户进度、对话记录和执行记录。
详见「4 运营」。
2. 配置
2.1 账户与 AI 模型
首次启动时先完成 HeyCivis 账户注册或登录。“邮箱”项即账户名，注册和登录必须使用同一个值。
登录后「设置 > 账号」显示账户状态：
| 项目 | 说明 |
|---|---|
| 邮箱 | 当前登录的账户名 |
| 密码 | 点击“更改”修改登录密码 |
| 余额 | 点击“充值”补充余额 |
| 订阅 | 显示当前订阅状态；没有订阅时点击“购买” |
| 授权 | 显示当前是否可以使用机器人 |
账户有可用余额或任意有效订阅时才能启动机器人；没有使用权限时仍可查看和修改配置，但不能启动机器人或通过 Skill 执行业务。
状态暂时无法确认时，检查网络后点击对应字段旁的重试图标。需要切换账户时点击“退出”。
AI 模型
模型用于生成搜索词、筛选客户和生成跟进内容。在「设置 > 账号」的 AI 模型区域填写：
| 配置项 | 填写内容 |
|---|---|
| 服务商 | HeyCivis、OpenAI、Anthropic、Google、DeepSeek 或 OpenAI-compatible |
| 模型 | 填写模型名称；选择 HeyCivis 时可填 heycivis 或 heycivis-pro |
| API key | 填写模型服务的 API Key；使用内置 HeyCivis 模型时无需填写 |
| API base | 使用 OpenAI 兼容服务时填写对应接口地址 |
保存后生效。
2.2 LinkedIn 账号与每日额度
LinkedIn 账号
在「设置 > 领英」中填写 LinkedIn 的邮箱和密码，点击“保存”。需要更换账号时，先点击“清除”再重新填写。
使用前先将 LinkedIn 界面语言切换为 English，否则机器人可能无法识别页面并正常操作。
每日额度
额度是每天最多分配的任务数，只影响「添加好友」和「持续跟进」两类任务。在「设置 > 领英」中分别设置每日连接额度和每日跟进额度，默认值为 20 和 25。
额度是当天的执行上限，不是必须完成的数量；设为 0 表示当天不执行对应动作。账号信誉越高，可以设置得越高；达到上限时当天剩余任务自动跳过，次日额度恢复后继续。稳定的额度有助于降低触发 LinkedIn 风控的概率，但不能保证账号不会受限。
2.3 工作
在「设置 > 工作」中选择工作时区，应与 LinkedIn 账号日常使用的环境一致。
工作时区同时决定机器人的工作时段、页面显示时间和自动化浏览器时区。修改后需重启机器人才会生效。
同页的“工作节奏”显示机器人当前的活跃时段、操作停顿、工作与休息节奏、连接复查间隔和匹配门槛，按拟人节奏执行，无需配置。
2.4 邮箱查询
在「设置 > 邮箱」中填写 BetterContact API 密钥并保存，即开通工作邮箱查询功能。
未填写密钥时，该功能不会开通：机器人不查询工作邮箱，客户通过筛选后直接进入发送好友申请流程，没有工作邮箱也可以发起申请。
开通后，机器人会在客户通过筛选后先查询其工作邮箱：找到邮箱才发送好友申请；未找到邮箱的客户会被标记为“无邮箱”。
留空保存即关闭邮箱查询。
2.5 网络
在「设置 > 网络」中检测当前环境能否访问 LinkedIn。点击“立即检测”，页面显示检测状态和最近检测时间。
机器人无法登录或长时间没有进展时，先在这里检测一次；检测不通时，检查网络或代理设置后重新检测。
2.6 Skill
Skill 用于通过支持 Agent Skills 的智能体（如 WorkBuddy、Codex、Claude）按需执行获客操作：挖掘客户、发送好友申请、检查连接结果、同步对话、生成跟进草稿、发送消息，以及查看和管理项目与客户。
自动机器人适合持续执行日常获客；Skill 适合由用户选择名单并确认外发的操作。两者共用同一套项目、客户、额度和业务状态。
在「设置 > Skill」中分别管理 WorkBuddy 和通用 Agent Skills 两处安装：未安装时点击“安装”，有新版或客户端路径变化时点击“更新”，不再使用时点击“卸载”。卡片显示当前版本和客户端内置的最新版本，两处安装互不影响。
安装或更新成功后，在对应智能体平台的新对话中输入 /heycivis-ai-sdr-agent 请执行安装自检。通过 Skill 执行业务前，先在任务页停止机器人并保持客户端运行；客户端未运行时会返回 CLIENT_NOT_RUNNING，启动客户端后再重试。
2.7 黑名单
黑名单中的客户不会再次进入获客流程。
在「设置 > 黑名单」中查看已拉黑的客户；移除后，该客户可能重新进入获客流程。
2.8 重置
「设置 > 重置」提供两个操作：
初始化
按顺序重新配置执行账号、AI 模型和首个项目，引导结束前需要确认使用条款，不会覆盖已有数据。
清空数据
删除全部客户、客户进度和执行记录，并重置搜索词，保留项目和账号配置。
执行“清空数据”前先停止机器人。
2.9 关于
「设置 > 关于」显示应用名称、当前版本、公司和联系邮箱。点击版本号旁的“检查”，有新版本时按钮变为“更新”，点击后前往下载页。
3. 项目
3.1 新建项目
项目决定机器人推广什么、寻找谁以及如何沟通。不同产品、市场或目标客户应分别创建项目。
在项目页右上角点击“+”，填写以下内容并保存：
| 配置项 | 填写要求 |
|---|---|
| 项目名称 | 使用容易识别的产品、市场或地区名称 |
| 执行账号 | 选择当前 LinkedIn 账号，创建后不可更换 |
| 业务介绍 | 说明产品、目标客户、解决的问题和核心价值 |
| 获客目标 | 说明找谁、如何筛选、聊什么以及如何推进 |
| 预约链接 | 填写会议预约或产品咨询地址 |
业务介绍和获客目标建议使用英文填写，以便与英文版 LinkedIn 资料和搜索词保持一致。
3.2 业务介绍
业务介绍说明产品、目标客户、解决的问题和核心价值，机器人据此生成搜索词并判断客户是否匹配。避免只写公司介绍或宣传口号。
示例：
HeyCivis（AI 获客智能体）是一款运行在本地电脑上的全自动获客机器人。HeyCivis 使用企业自己的 LinkedIn 账号，在 LinkedIn 上自动寻找潜在客户，完成背景调查、匹配判断、个性化触达和持续跟进，并在客户产生兴趣后邀请预约或转交销售。产品支持 50+ 种语言的商务沟通，帮助企业持续稳定地开发全球客户，减少对展会、转介绍和手动维护客户名单的依赖。
3.3 获客目标
获客目标说明找谁、如何筛选、聊什么以及如何推进，应包含以下六项：
| 序号 | 内容 | 填写要求 |
|---|---|---|
| 1 | 目标客户 | 职位、行业、地区、公司规模和典型特征 |
| 2 | 筛选标准 | 明确哪些客户符合要求、哪些不符合 |
| 3 | 切入话题 | 首次沟通优先讨论的问题或业务场景 |
| 4 | 兴趣信号 | 客户出现哪些表达时可以继续推进 |
| 5 | 推进动作 | 写明兴趣出现后的具体动作，例如邀请产品咨询并引导填写预约链接 |
| 6 | 不触达对象 | 不希望联系的人群、行业、职位或场景 |
示例：
目标客户：面向全球市场销售 B2B 产品或服务的企业中，负责销售增长和业务拓展的创始人、销售负责人、市场负责人和国际业务负责人。
筛选标准：企业向商业客户销售产品或服务，有明确的目标行业、国家或采购角色，并希望持续开发新客户；以 B2C 为主且无 B2B 需求的企业，以及求职者、招聘人员、学生和非相关岗位不符合要求。
切入话题：企业目前如何寻找新客户，以及在获客、背景调查、多语言触达和跟进中遇到的问题。
兴趣信号：客户提到依赖展会或转介绍、手动搜索效率低、缺少多语言销售能力、跟进不连续，或希望获得更多高质量销售线索。
推进动作：客户确认存在获客需求并愿意了解方案后，邀请其参加 30 分钟产品咨询，并引导其通过预约链接选择时间。
不触达对象：求职者、招聘人员、学生、同类软件供应商，以及与销售或商务拓展无关的岗位。
预约地址单独填写在项目的“预约链接”中。
3.4 种子客户
种子客户是已经确认符合项目要求的客户，无需机器人重新搜索和筛选，例如现有目标名单或销售指定联系人。
在项目详情中点击“种子客户”，粘贴完整的 LinkedIn 个人主页链接，每行一个。重复客户和无效链接会被跳过。
https://www.linkedin.com/in/example-one/
https://www.linkedin.com/in/example-two/种子客户会跳过搜索、AI 筛选和邮箱查询，直接进入“已筛选”，之后仍会读取资料并按正常流程执行好友申请、申请检查和跟进。这里只应导入已经确认合适的客户。
3.5 修改、导出与删除
修改
“项目配置”可修改项目名称、业务介绍、获客目标和预约链接。修改内容只影响之后处理的客户。
导出
“导出”可将客户资料和进度导出为 Excel。
删除
删除项目会同时删除该项目的客户、执行记录和搜索词。删除前先停止机器人。
4. 运营
4.1 客户进度与对话
“客户进度”用于查看和筛选项目内的全部客户。主要阶段：
| 阶段 | 含义 |
|---|---|
| 已筛选 | 符合项目要求，等待继续处理 |
| 待添加 | 等待发送好友申请 |
| 等待通过 | 好友申请已发送 |
| 已连接 | 已成为 LinkedIn 联系人，可以跟进 |
| 已关闭 | 本轮跟进已经结束 |
| 已失败 | 客户不匹配或操作无法继续 |
| 无邮箱 | 未找到可用的工作邮箱 |
点击客户名称可打开其 LinkedIn 主页；点击“详情”可查看邮箱、筛选原因、客户结果和对话记录。客户结果包括：已约会议、明确拒绝、不匹配、无预算、已有方案、时机不合适、无回应、未知结果。
客户数量较多时，列表底部显示“加载更多”继续加载下一批客户，同时显示“共 N 条”总数。
4.2 执行记录与搜索词
“执行记录”显示已经发生的加好友和跟进动作。
“搜索词”显示机器人使用的关键词及使用状态，也可以手动添加或删除。
4.3 今日额度与任务
“今日额度”显示当天已使用的连接和跟进额度，达到上限后不再执行对应动作。
“今日任务”显示加好友、检查好友申请和跟进客户三类任务及其状态；点击“查看全部”可按项目、状态和类型筛选。
停止机器人后，可以清空尚未执行的计划任务；已经完成的任务不会被删除。
5. Skill 使用
Skill 用于通过支持 Agent Skills 的智能体（如 WorkBuddy、Codex、Claude）按需操作获客业务。与自动机器人持续执行不同，Skill 适合查看结果、处理指定客户、调整草稿和完成需要确认后才会外发的操作；两者共用同一套项目、客户、额度和业务状态。安装与配置见「2.6 Skill」。
5.1 使用前准备
- 已安装客户端，完成 HeyCivis 账户登录、模型和 LinkedIn 账号配置，并确保账户有可用余额或有效订阅；
- 已在智能体平台安装 Skill，并完成安装自检（见「2.6 Skill」）；
- 使用 Skill 执行业务前，先停止机器人，并保持客户端运行。
项目保存的业务介绍和获客目标决定实际的搜索、筛选和沟通。临时提出的新行业、地区、职位或筛选条件不会自动写入项目；需要先选择沿用当前目标、修改项目或新建项目。
5.2 常用对话
| 目标 | 可以这样说 |
|---|---|
| 查看项目 | 列出我的所有项目 |
| 查看项目客户 | 在“制造业获客”项目里看看当前有哪些客户 |
| 挖掘并准备连接 | 在“制造业获客”项目挖一批客户并准备发好友申请 |
| 查看连接结果 | 查看这个项目的连接结果 |
| 指定客户跟进 | 给 hans-sales 写一条跟进消息，先不要发送 |
| 修改项目 | 修改“制造业获客”的切入话题，其他内容保持不变 |
| 修改客户记录 | 把当前名单第 3 位客户记录为已失败，结果是不匹配，原因是企业只做国内市场 |
同一对话会复用当前项目。项目名唯一时会直接继续任务；同名或未指定项目时才要求选择。客户可以按名称或当前名单序号选择，名单刷新后旧序号失效。
少量结果直接在对话中展示；长名单、多客户消息草稿和批量结果会生成按日期存放的本地 HTML 报表并直接打开。需要继续处理报表中的客户时，可以直接使用当前报表序号；报表无法自动打开时，会提供已生成的本地文件位置。
5.3 确认规则
| 操作 | 行为 |
|---|---|
| 搜索、筛选、检查连接、同步对话、生成草稿 | 直接执行 |
| 发送好友申请 | 展示最终连接名单后等待确认 |
| 发送消息或结束跟进 | 展示最终草稿、建议和客户结果后等待确认 |
| 修改客户阶段或结果 | 展示最终变更后等待确认 |
当对话中只有一个刚展示的待确认动作时，可以直接说“就按这个执行”“确认”或其他明确同意语句。修改名单或草稿、刷新名单、切换项目或开始其他任务后，旧版本不能再确认。
外发结果不明确时，Skill 会停止后续外发，不会自动重试；先到 LinkedIn 核对实际结果再继续。
6. 运行原理
6.1 整体运作流程
完成账户、LinkedIn 账号、额度和 AI 模型等设置并创建项目后，在任务页启动机器人。机器人在工作时段内自动生成并分配三类任务——加好友、检查申请和跟进客户，无需手动逐条创建；其中加好友和跟进客户消耗每日额度，检查申请不受额度限制。客户通过筛选后发送好友申请，通过后进入跟进，出现明确兴趣后引导其填写预约链接。执行情况在项目页查看客户进度、对话和执行记录，在任务页查看当天额度和任务。
7. 常见问题
7.1 运行日志
“运行日志”显示机器人当前执行内容和错误信息。出现异常时按日志提示处理：
| 页面表现 | 处理方法 |
|---|---|
| 账户需要重新登录 | 返回登录页重新登录 |
| 没有使用权限 | 在「设置 > 账号」充值余额或购买订阅 |
| 账户状态暂时无法确认 | 检查网络后点击对应字段旁的重试图标 |
| 模型接口报错 | 检查模型名称、API key 和 API base |
| LinkedIn 访问不通 | 在「设置 > 网络」检测，检查网络或代理设置 |
| LinkedIn 未登录或触发安全验证 | 在自动打开的浏览器中完成登录或验证后重新启动 |
| LinkedIn 页面不是英文 | 切换为 English 后重新启动 |
7.2 常见问题
关闭窗口后机器人还在运行吗？
还在。关闭窗口只是把应用隐藏到系统托盘，机器人继续运行；完全退出需使用托盘菜单中的“退出”。详见「1.3 启动、停止与窗口行为」。
客户数据保存在哪里？
客户资料、对话记录和跟进进度保存在本机用户数据目录，不会上传到服务器。详见「1.1 产品介绍」。
当天额度用完了怎么办？
剩余任务会自动跳过，次日额度恢复后继续执行。详见「2.2 LinkedIn 账号与每日额度」。