管理员快速入门

1. 概述

1.1 适用读者与目标

本文面向帆倍管理员，帮助你完成企业初始化、权限配置、AI 能力配置、表单基础配置和外部系统接入配置。

管理员的核心目标是：让销售团队能看到正确的数据、使用合适的 AI 能力，并确保企业的业务规则、权限边界和集成能力配置完整。

1.2 首次配置顺序

本节是全文的主线。若你正在初始化帆倍，建议严格按下表顺序逐项完成。

2. 企业初始化配置

2.1 版本信息与 AI 积分

配置前先确认企业当前版本、有效期、系统容量与功能开通范围，避免把版本权限限制误归因为配置问题。

详情请参见：「版本信息」

2.2 管理员角色

企业创建成功后，创建者可将企业管理权限下放，让普通用户获得全部或部分管理权限，避免管理工作集中在单一账号。

详情请参见：「企业管理组」

2.3 企业身份

企业身份是当前企业信息的结构化描述，用于让帆倍明确三件事：我们是谁、我们卖什么、我们关注哪类客户。它是 AI 生成客户分析、销售建议与访前准备内容时的核心上下文。

建议维护以下内容：

1）企业名称。

2）企业简介。

3）主要产品线。

4）目标客户类型。

5）关注行业。

6）常见销售场景。

7）企业希望 AI 重点关注的信息。

配置建议：

1）内容应真实、简洁，避免写成宣传稿。

2）产品线和目标客户尽量具体。

3）企业业务方向发生变化时，应及时更新企业身份。

4）若销售反馈 AI 建议不贴合业务，优先检查企业身份是否过旧或过于宽泛。

详情请参见：「配置企业身份」

3. 表单基础配置

3.1 商机阶段

商机阶段用于将企业销售流程拆解为可跟进的标准阶段，例如初步接触、需求确认、方案沟通、商务谈判、赢单、输单。阶段划分直接影响商机跟进口径、预测准确度与漏斗分析结果。

每个阶段通常需要配置：阶段名称、阶段排序、默认赢率、是否为终态、是否代表赢单或输单。

配置建议：

1）阶段数量不宜过多，应符合销售团队真实使用习惯。

2）赢率应与企业历史经验接近，避免过高或过低。

3）赢单、输单等终态必须清晰，便于报表和预测统计。

详情请参见：「商机阶段」

3.2 表单字段

「表单字段」用于维护帆倍五张核心业务表单的字段结构，使表单采集的信息与企业实际销售管理口径一致。字段结构直接影响业务用户的录入成本、报表维度与 AI 分析质量。

可维护的五张表单如下：

详情请参见：「表单字段」

3.3 导入初始表单数据

数据导入主要服务于数据迁移和批量初始化。管理员可以将外部 CRM、Excel 台账或旧系统中的客户、联系人、商机、记录等数据，按照帆倍表单字段定义批量导入。

3.4 分配表单权限

权限配置决定不同用户能访问哪些数据、能执行哪些操作。管理员应根据企业组织结构与管理规则配置权限组。

配置建议：

1）先按角色建立权限组，例如销售、销售主管、销售管理者、运营管理员。

2）对普通销售用户，通常只开放其负责范围内的数据；对管理者可开放团队或全局数据范围。

3）对敏感字段，单独确认字段可见性和可编辑性。

4）新员工加入或员工角色变化时，及时调整权限组成员。

详情请参见：「业务权限配置」

4. AI 能力配置

本章四节按推荐配置顺序排列：先备齐技能、工具与连接器，再把它们挂载到智能体上。

请在最开始，分清智能体、技能、工具、连接器的职责。

4.1 技能

技能是给智能体配备的操作说明书，把具体工作拆解为可执行的步骤。在帆倍中，技能是面向具体销售场景的专项能力，例如客户洞察、访前准备、跟进总结、可视化报告。

配置建议：

1）优先保证高频场景的技能可用，例如访前准备和跟进记录整理。

2）根据销售团队反馈，持续优化输出格式和业务重点。

3）当某项能力效果不稳定时，用真实业务案例进行测试和调整。

详情请参见：「技能」

4.2 工具

工具是智能体可以调用的外部功能模块，例如「网页搜索」或「对象数据访问工具组」。技能会根据任务需要决定是否调用这些工具。

在帆倍中，工具通常用于四类动作：读取表单数据、检索上下文、写入记录、执行外部系统动作。

配置建议：

1）只给智能体开放业务确实需要的工具。

2）当销售反馈 AI 查不到数据时，优先检查工具是否可用、权限是否完整。

详情请参见：「工具」

4.3 连接器

连接器用于接入第三方 MCP 服务，例如企业微信、邮件系统、数据库。接入后，当前企业帆倍中的智能体可获得这些新的工具能力，由管理员统一管理开放范围。

详情请参见：「连接器」

4.4 智能体

智能体是一个具备自主决策能力的 AI 核心，负责理解用户意图、做出决策，并自主调用各类技能与工具完成具体任务，无需用户逐步手动指挥。

在帆倍中，最常用的智能体是销售助手，用于支持客户洞察、访前准备、跟进总结、报表分析等场景。

配置建议：

1）不要频繁修改核心智能体配置，避免影响一线销售体验。

2）修改后建议用典型销售问题进行测试，例如客户洞察、访前准备、商机风险分析。

3）若 AI 无法读取某类业务数据，优先检查智能体是否具备对应工具。

4）若 AI 在某个专项任务上效果不好，优先检查相关技能配置。

详情请参见：「智能体」

5. 外部系统接入

5.1 对象映射

对象映射用于配置外部系统字段和值与帆倍内部对象模型之间的关系。

常见用途包括：外部客户数据同步到帆倍客户对象、外部联系人字段映射到联系人对象、外部商机阶段映射到帆倍商机阶段。

配置建议：

1）先确认外部系统字段含义，再做映射。

2）枚举值要逐项确认，例如客户状态、商机阶段、角色类型。

3）上线前用少量测试数据验证映射结果。

5.2 API Key

API Key 用于外部系统调用帆倍 API 时进行鉴权。

管理员需要关注：API Key 用途、调用方系统、是否配置 IPv4 白名单、是否有过期或轮换机制。

配置建议：

1）不同系统使用不同 API Key，便于跟踪和停用。

2）只向可信系统提供 API Key。

3）配置 IP 白名单，减少密钥泄露风险。

5.3 Webhook

Webhook 用于在帆倍中的数据发生变化时，把事件推送给外部系统。

常见事件包括对象记录创建、对象记录更新、对象记录删除。

配置建议：

1）明确接收方地址和事件类型。

2）上线前测试外部系统是否能正确接收和处理事件。

3）外部系统应支持失败重试或异常告警。

4）只订阅确实需要的事件，避免产生不必要的数据推送。

5.4 集成配置

集成配置用于连接企业协同系统，例如钉钉集成与钉钉用户绑定。

管理员应确认：

1）企业集成参数是否正确。

2）用户绑定关系是否完整。

3）会议纪要、附件或人员能力是否能正常流转。

4）新员工加入后是否完成绑定。

6. 上线前检查清单

上线前建议逐项确认以下内容。

7. 日常运维建议

管理员应定期检查以下内容，建议至少每季度一次。

8. 常见问题

问：用户看不到某个菜单或按钮怎么办？

答：请依次检查：

1）用户是否进入正确企业；

2）用户是否在正确权限组内；

3）对应对象权限是否开启；

4）操作权限是否允许查看、新建、编辑或删除；

5）字段权限是否限制了相关字段；

6）数据范围是否覆盖该用户要查看的数据。若以上均正常，再在「版本信息」中确认该功能是否已开通。

问：AI 回答不够贴合业务怎么办？

答：请优先检查：

1）企业身份是否完整且不过旧；

2）智能体角色说明是否准确；

3）工具是否能读取所需业务数据；

4）技能是否覆盖当前任务场景；

5）客户、商机、记录、任务等数据是否完整。

问：外部系统无法调用 API 怎么办？

答：请检查：

1）API Key 是否正确；

2）API Key 是否已启用；

3）调用方 IP 是否在白名单内；

4）请求对象和字段是否符合对象映射配置；

5）外部系统是否使用了正确的环境和接口地址。

问：Webhook 没有收到事件怎么办？

答：请检查：

1）Webhook 是否启用；

2）订阅事件类型是否正确；

3）接收地址是否可访问；

4）外部系统是否返回成功状态；

5）是否存在网络、防火墙或鉴权问题。

问：可以跳过企业身份直接配置 AI 能力吗？

答：不建议。企业身份是 AI 生成客户分析与销售建议的核心上下文，缺失或过于宽泛时，AI 输出与实际业务的贴合度会明显下降。