LinkAI 智能体接入网页——嵌入 AI 对话窗到任意网站

网站是 LinkAI 智能体接入最基础也最常见的渠道——把一个已经在 Builder 里做好的应用或工作流，用一段代码接到网页上，用户就能直接和它对话。

两种接入方式

方式 1：网页嵌入组件（推荐，最省事）

LinkAI 提供了封装好的对话窗组件，只需几行代码就能嵌入到你的网站里：

<!-- 基础嵌入代码，从 LinkAI 控制台生成后复制 -->
<script src="https://link-ai.tech/static/widget.js"></script>
<div id="linkai-widget"></div>
<script>
  LinkAI.init({
    app_code: "你的应用 app_code",
    element: "#linkai-widget"
  });
</script>

在 控制台 → 渠道接入 → 网页嵌入 页面可以在线生成这段代码，支持：

• 嵌入位置：页面右下角悬浮窗 / 页面内嵌区域 / 全屏对话
• 外观定制：头像、主题色、按钮样式、欢迎语
• 语音输入：HTTPS 网站 + 浏览器麦克风权限时可用
• 移动端适配：自动响应式

方式 2：Open API 接入

如果你需要更深度的集成（比如把 LinkAI 对话能力接进你自己的聊天界面、小程序、App），用开放 API 更灵活：

• API 根地址：https://api.link-ai.tech/v1
• 通用对话接口、记忆对话接口、图像/视频/语音接口
• 鉴权方式：Authorization: Bearer {API Key}
• 完整接口文档见在线调试平台

API 返回里会包含插件执行链路、思考过程等结构化信息，适合前端自定义展示。

配置步骤（网页嵌入）

1. 准备好应用 / 工作流——先在 Builder 里创建并调试好
2. 获取 app_code——在应用卡片或详情页可以找到，每个应用唯一
3. 进入渠道接入 → 网页嵌入——选择要接入的应用，生成嵌入代码
4. 配置外观——头像、主题色、欢迎语、嵌入位置等
5. 复制代码到你的网站——把代码块粘贴到网站 HTML 里，部署上线即可
6. 测试——打开你的网站，点击悬浮图标开始对话

功能特性

对话窗口样式

• 悬浮窗：右下角气泡图标，点击展开对话，不遮挡主要内容
• 内嵌面板：嵌入到页面指定区域（比如帮助中心页面、FAQ 旁边）
• 全屏模式：适合独立的 AI 对话页面

对话体验

• 支持 Markdown 渲染（列表、表格、代码块）
• 支持图片发送和识别
• 支持语音输入和语音回复
• 支持多轮对话上下文保持
• 支持用户主动"重置会话"

高级配置

• 引导问题：在欢迎语里用 [问题] 格式预置几个常见问题，用户点击即可发送
• 转人工：知识库应用配置转人工开关后，对话窗口里会出现转人工按钮
• 对话记录：用户的对话历史可以在 LinkAI 后台统一查看和管理

HTTPS 要求

• 语音输入功能需要 HTTPS 协议（浏览器安全策略）
• 纯文本对话不需要 HTTPS 也能工作，但生产环境强烈建议全站 HTTPS

与其他渠道的关系

网页嵌入、微信系、飞书钉钉、海外渠道都在 LinkAI 平台里是平级的渠道接入方式——同一个应用可以同时接到多个渠道，所有渠道共享同一个知识库、插件、模型和工作流配置。后台可以统一管理所有渠道的对话记录、客户信息和运营数据。