首先获取天宫AI开发者权限并创建项目，通过审核后获得AppID和SecretKey；接着根据技术架构选择API或SDK对接方式，下载对应文档与示例代码；然后在前端引入JS脚本挂载对话组件，配置样式与触发参数；同时在后端实现身份验证，使用SecretKey生成签名并转发消息至天宫AI接口；最后完成测试验证、灰度发布，确认无误后上线运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将天宫AI的能力集成到自己的网站或应用程序中，以实现智能对话、自动应答等功能，则需要完成接口对接与功能嵌入。以下是具体操作流程：
一、获取天宫AI平台接入权限
在开始对接之前，必须拥有天宫AI开放平台的开发者账号和相应的服务权限。只有通过认证的开发者才能调用API接口或获取嵌入代码。
1、访问天宫AI开放平台官网，使用企业或个人身份注册开发者账户。
2、登录后进入“项目管理”页面，点击“创建新项目”，填写项目名称、应用场景等基本信息。
3、提交审核资料，等待平台审核通过后，系统将分配唯一的AppID和SecretKey。
AppID和SecretKey是后续调用接口的核心凭证，请妥善保管。
二、选择对接方式：API接口或SDK嵌入
根据技术架构和开发需求，可以选择基于HTTP协议的API接口调用，或使用官方提供的SDK进行深度集成。两种方式适用于不同场景。
1、若网站采用前后端分离架构，推荐使用RESTful API方式进行请求交互。
2、若APP为原生开发（如Android/iOS），建议下载对应语言版本的SDK包并导入工程。
3、访问文档中心，下载最新的接口说明文档和示例代码压缩包。
API接口地址通常为 https://api.tiangong-ai.cn/v1/chat，需携带签名认证头。
三、配置前端嵌入组件
为了在网页端展示天宫AI对话窗口，可通过引入JavaScript脚本实现快速挂载。该方法无需复杂开发，适合静态站点快速部署。
1、在天宫AI管理后台找到“前端嵌入”选项，生成适用于当前域名的JS代码片段。
2、将生成的<script>标签复制到目标网页的<head>区域或页脚位置。</script>
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
3、设置弹窗样式参数，包括颜色主题、初始问候语、触发按钮位置等。
每个域名需单独授权，未经备案的域名无法加载聊天组件。
四、实现后端身份验证与消息转发
为保障通信安全，所有来自客户端的消息都应经由自有服务器进行签名验证后再转发至天宫AI服务端。
1、客户端发送用户输入内容至您的业务服务器。
2、服务器使用SecretKey对请求参数进行HMAC-SHA256签名计算。
3、构造标准JSON格式请求体，包含timestamp、nonce、signature字段，并附加原始消息内容。
4、通过HTTPS POST方法将数据提交至天宫AI网关接口。
每次请求的signature必须动态生成，防止重放攻击。
五、测试与上线部署
完成编码后需进行全面测试，确保消息收发正常、响应延迟可控、异常处理机制健全。
1、在测试环境中模拟多种用户输入，检查返回结果是否符合预期。
2、利用日志系统监控接口调用状态码和响应时间。
3、开启流量灰度发布，先向10%用户开放体验功能。
4、确认无重大错误后，在管理后台切换为“生产模式”运行。
