AI 实例设置

功能简介

系统的 AI 能力由易客 CRM 智能体提供——一条嵌在易客 CRM 里的 AI 助手，分三层：你的页面、安全网关和 AI 引擎。AI 引擎在控制面板里叫「实例」，就在本页管理：前台右侧的 AI 助手、每个用户名下的 Agent、飞书和微信等 IM 渠道，以及 AI 自动填充里的「联网查找」，都是这个引擎在干活。CRM 连接实例所需的地址、发布密钥和管理员账号由实施人员写在服务器配置文件里，本页只读取、不能修改，也不显示密钥；本页做两件事：显示实例是否可达，以及维护两项保存在实例上的设置——实例反过来读取 CRM 数据时用的「CRM 接口地址」，和随每次对话下发给 AI 的「行为约定」。

页面概览

• 页签：「AI 智能助手」组的四个页面共用页面顶部的一排页签「AI 实例设置」「模型设置」「用户与 Agent」「AI 填充队列」，与左侧导航一一对应。
• 「Agent 实例」卡片：显示「实例地址」和「状态」，标题旁的标记是「运行正常」或「不可达」。
• 「实例配置」卡片：「CRM 接口地址」文本框、「行为约定」多行文本框和「保存」按钮，按钮旁注明「保存后立即对新会话生效。」；只在实例可达时显示。
• 提示条：连接参数没有填写时整页只显示「未配置：请在……中填写……」；填了但连不上时，卡片下方显示「服务不可达，无法读取/保存实例配置。请确认……已在 主机:端口 启动。」。

操作步骤

检查实例是否在线

1. 打开本页，看「Agent 实例」卡片：标记为绿色「运行正常」、「状态」一行显示「运行正常，可达」，说明 CRM 能连上实例；标记为红色「不可达」时，「状态」后面的括号里是失败原因，下方的「实例配置」卡片不再显示。
2. 实例不可达时把括号里的原因告诉实施人员，由他们在服务器上检查实例是否启动、地址是否正确；页面上没有可以点击的检测或重连按钮，处理好后刷新本页即可。

整页只有一条「未配置」提示时，表示连接参数还没有填，同样交给实施人员处理。

填写 CRM 接口地址和行为约定

1. 在「CRM 接口地址」填实例访问本系统时使用的地址，只填到域名或主机加端口，例如 https://crm.example.com，不带后面的路径。
2. 在「行为约定」用自然语言写清本系统的字段命名习惯、模块和表的对应关系、哪些模块可用或禁用等，AI 查数据时会照着做。
3. 点击「保存」，页面刷新并在标题下显示「✓ 已保存」。地址为空或不是以 http://、https:// 开头时保存被拒绝，显示「✕ 保存失败，请稍后重试」，实例不可达时也是这条提示。

两项设置一起保存到实例上，保存后新开的对话立即使用新内容，已经打开的对话不受影响。不需要到「设置中心」清除缓存，也不需要重新登录。

了解 AI 引擎在前台的表现

前台每个用户的右下角都有「AI」按钮，但只有在「用户与 Agent」开通了助手的员工点击后才能打开可用的 AI 助手（右侧滑出的智能体面板，见「用户与 Agent」一章）；AI 引擎不可达时，点击按钮只会显示「Copilot 服务未启动或不可达」。「业务规则」一章里「调用 AI Agent」这一步同样通过 AI 引擎派发任务，引擎不可达时这一步被跳过，记录照常保存；「AI 填充队列」一章里「联网查找」模式的任务则会报错并按队列规则重试。

字段与选项说明

字段	含义	备注
「实例地址」	服务器配置文件里填写的实例访问地址	只读，通常是本机回环地址加端口
「状态」	「运行正常，可达」或「不可达（原因）」	每次打开本页实时探测一次
「CRM 接口地址」	实例反查 CRM 数据时访问本系统的地址	必填，须以 http:// 或 https:// 开头，只填域名部分
「行为约定」	随每次对话下发给 AI 的系统级说明	自然语言，可留空

注意事项

• 「CRM 接口地址」填错的后果不是保存失败，而是 AI 助手在对话里取不到 CRM 数据；改过域名或端口后记得同步改这里。
• 「行为约定」会原样附在每次对话里，写得越长每次对话消耗越多，只写 AI 容易搞错的规则即可，不要写入密码、密钥等敏感内容。
• 「模型设置」「用户与 Agent」两页读写的也是实例上的数据：实例不可达时「模型设置」只显示「服务不可达：原因」；「用户与 Agent」的列表照常显示，但开通、保存等操作会失败，详情页各页签显示「服务不可达」类的提示。