主题
开发者中心
「开发者中心」是面向有技术对接需求的品牌方/开发者的管理入口,负责所有涉及接口调用与外部服务对接的凭证与配置。
1. 包含哪些能力
开发者中心分为两大子模块:
| 子模块 | 用途 | 何时使用 |
|---|---|---|
| API 密钥管理 | 获取调用 JoyInside 平台接口所需的身份凭证 | 需要通过代码/接口与平台交互时(如设备自动注册、发起对话) |
| 第三方服务管理 | 注册您自有的外部 Agent(即"第三方服务"),供自定义技能按 A2A 协议 调用 | 创建 自定义技能 前必须先在这里登记 Agent 的 URL、鉴权、协议 |
2. 在整体平台中的位置
开发者中心的两个能力,分别对应「平台调你的接口」与「你调平台的接口」两个方向:
你的服务端 ── (API 密钥) ──▶ JoyInside 平台
│
│ 触发自定义技能时
▼
JoyInside 平台 ── (第三方服务配置 · A2A 协议) ──▶ 你的外部 Agent- API 密钥:JoyInside 认识你——你调平台接口时,平台通过 Access Key + Secret Key 验证你的身份;
- 第三方服务:JoyInside 认识你的 Agent——用户对话触发自定义技能时,平台知道要把请求按 A2A 协议发到哪个 URL、用什么 Token 鉴权,并接收 Agent 流式返回的
Message/Instruction/Done事件。
两者搭配起来,才能完成「设备接入 + 自定义技能」的完整闭环。
3. 典型开发链路
一个新品牌方从零接入到上线的完整链路:
1. 创建 API 密钥(用于设备接入等接口调用)
↓
2. 创建第三方服务(注册外部 Agent 的 URL、鉴权和 A2A 协议信息)
↓
3. 保存并校验通过 → 启用服务
↓
4. 在技能库中创建自定义技能,关联该第三方服务(即绑定该 Agent)
↓
5. 用户对话触发该技能时,平台按 A2A 协议调用您的 Agent 并原样透传其流式响应
↓
6. 硬件出厂 → 首次联网 → 通过 API 密钥自动注册到设备管理4. 注意事项
- API 密钥每企业只有一对:一个企业只能创建一个密钥对,支持编辑和删除;
- Secret Key 是账号级密码:一旦泄露他人可调用你的接口,必须妥善保管;
- 先建服务、再建技能:自定义技能需要选择已有的第三方服务,顺序不能反;
- 服务必须启用:第三方服务在禁用状态下,技能库看不到、不可选;
- 校验失败无法保存:请确保接口地址可正常访问、鉴权信息正确。