分享、公开访问与网站嵌入

Agent 调优验收完成后,可以在「访问」页签按受众范围灵活发布:开放给本组织成员、发一条免登录公开链接、放进企业官网或内网门户,或者签发专属 API 密钥对接业务系统。

打开目标 Agent,切换到顶部的访问页签。页面按触达范围由内到外分为成员使用、公开访问和API三段;公开链接、网站气泡和页面内嵌可以同时使用。只有能编辑该 Agent 的维护者可修改设置,其他成员看到的是只读视图。

Agent 访问配置页:成员使用、公开访问、网站嵌入与 API 密钥
Agent「访问」页签:统一管理组织内开放范围、免登录公开链接、网站嵌入代码与专属 API 密钥。

开放给组织成员

新建的 Agent 默认仅维护者本人可见。在成员使用中将「谁可以对话」切换为组织成员后,本组织内具备 Agent 使用权限的同事即可直接发起对话,无需开启公开访问,也不会暴露到外部网络。

发布免登录公开链接

适合官网产品咨询、公开帮助中心或活动问答场景:

打开允许免登录访问开关。确认弹窗会明确列出当前 Agent 的运行身份、可访问的知识库和已启用的工具,核对无敏感资料后再确认开启。

在聊天界面中配置窗口标题、欢迎语、主题风格、入口图标,以及是否向访客展示思考过程、工具调用状态和复制按钮(思考过程和工具调用默认关闭,开启后仅显示步骤与状态,不暴露敏感参数或原始结果)。点击本区块的保存后对访客生效。

利用右侧预览区在「链接页面」「聊天气泡」「页面内嵌」三种形态间切换核对效果,确认无误后复制公开链接发送出去。

如果开关呈灰色并提示「组织不允许公开内容」,说明组织管理员在组织设置中关闭了公开分享能力。此外,持有组织管理权限的 Agent 禁止开启免登录访问。

关闭「允许免登录访问」后,公开链接、嵌入代码与界面配置立即失效。公开访问内置按 IP 与会话维度的访客限流;如需限制单个公开 Agent 的总用量,平台管理员可在后台为该 Agent 的服务身份配置总额度。

嵌入企业网站或内网门户

开启公开访问后,在嵌入网站区域可以任选两种嵌入方式(无需额外配置域名白名单):

复制生成的脚本标签,粘贴到网页 HTML 的 </body> 结束标签之前。网页右下角会自动出现可折叠的悬浮聊天入口,图标与欢迎语复用上方「聊天界面」配置。

切换到「页面内嵌」复制 <iframe> 代码,直接放入内网知识门户或业务系统页面指定容器中,完整呈现对话窗口。

从官网一键搭建客服 Agent:在 Agent 列表页点击从网站创建,输入公开官网地址并勾选页面后,系统会自动建库、抓取网页并生成预设好对话界面的 Agent,完成后直接进入此页预览并复制气泡代码即可上线。

签发 Agent 专属 API 密钥

需要从自有后端或前端应用以编程方式调用该 Agent 时,在API区域签发专属密钥(无需开启公开访问):

  1. 点击创建密钥,填写用途备注(例如「官网客服后端」)。
  2. 立即复制弹窗中显示的密钥并保存到服务端环境变量 APEMIND_API_KEY——密钥仅展示这一次。
  3. 密钥仅能调用当前这一个 Agent,并以该 Agent 自身的服务身份和资源权限运行,即使密钥创建者日后离职也不影响线上服务。不再使用时点击撤销即刻失效。

页面自带可直接复制的调用示例,完整接口规范请参阅开发者文档Agent 访问点与运行身份。

下一步