帮助中心
吉易鸥 AIGEO · 每个功能都有详细操作指引
← 返回平台首页
← 返回帮助列表

小鸥开放能力总览:怎么把你的系统接进来

小鸥 API · 更新于 2026-10-15 17:10

一、一句话说明

「小鸥」是吉易鸥 AIGEO 平台里的 AI 问答能力。任何外部网站 / 系统(企业官网、便民平台、小程序、内部 OA、客服系统……)都可以通过开放接口,把内容交给小鸥、把问答能力接回自己的页面——攻略宝便民系统就是这么接入的。

你想实现的效果用哪个接口要 Key 吗
让用户在你的页面里问「你们自己的事」,由小鸥回答数字员工挂件 Widget(最省事)不要(靠 tenant 隔离)
把你们网站的文章 / 招聘 / 商家 / 资讯批量喂给小鸥推送同步 api/tenant_ingest.php要(企业级 Key)
后端调一次拿到文字答案 + 语音,自己渲染开放聊天 api/open_chat.php要(同一把 Key)

二、接入前准备三样东西

  1. 环境域名:测试 https://i.gonglve.com.cn,正式 https://aigeo.gonglve.com.cn。⚠️ 只填域名,不要拼 /api/open_chat.php 之类的路径——否则你们的同步地址会被拼重,请求会落到聊天接口,只会看到「message required」。
  2. 企业 tenant:由吉易鸥运营在总后台为贵司建一个企业租户(状态「启用」)。
  3. 开放 API Key:每个租户一把独立密钥,推送同步与开放聊天共用。

三、Key 在哪里生成

  • 总后台:租户管理 → 编辑该租户 → 底部「开放 API Key」→ 勾选「重新生成」→ 保存 → 复制发给技术。
  • 企业端自助:登录企业后台 → 企业基础信息 → 「开放 API Key」卡片 → 生成 / 重新生成(泄露可随时重置,旧 Key 立即失效)。

四、接线顺序(照这个顺序做最快)

1取域名与 Key
2先自检
3推送内容
4调聊天接口
5上线验收
▶从零接通小鸥(5 步 · 点步骤看画面)共 5 步 · 点上方步骤查看画面
aigeo.gonglve.com.cn/api/tenant_ingest.php
开放 API · 快速接入
POST/api/tenant_ingest.php
Authorization: Bearer <你的开放 API Key>
{ "docs": [ {"external_id":"gl-1001","category":"recruit",
  "title":"招聘:本地生活运营专员","content":"…"} ] }
→ {"ok":true,"total":1,"inserted":1,"errors":[]}
GET/api/tenant_ingest.php自检 → auth:true
1只填域名,例如 https://i.gonglve.com.cn,不要拼到 .php
aigeo.gonglve.com.cn/api/tenant_ingest.php
开放 API · 快速接入
POST/api/tenant_ingest.php
Authorization: Bearer <你的开放 API Key>
{ "docs": [ {"external_id":"gl-1001","category":"recruit",
  "title":"招聘:本地生活运营专员","content":"…"} ] }
→ {"ok":true,"total":1,"inserted":1,"errors":[]}
GET/api/tenant_ingest.php自检 → auth:true
2总后台租户管理,或企业端「企业基础信息 → 开放 API Key」生成
aigeo.gonglve.com.cn/api/tenant_ingest.php
开放 API · 快速接入
POST/api/tenant_ingest.php
Authorization: Bearer <你的开放 API Key>
{ "docs": [ {"external_id":"gl-1001","category":"recruit",
  "title":"招聘:本地生活运营专员","content":"…"} ] }
→ {"ok":true,"total":1,"inserted":1,"errors":[]}
GET/api/tenant_ingest.php自检 → auth:true
3浏览器直接打开 /api/tenant_ingest.php,返回 ok:true 说明接口已上线
aigeo.gonglve.com.cn/api/tenant_ingest.php
开放 API · 快速接入
POST/api/tenant_ingest.php
Authorization: Bearer <你的开放 API Key>
{ "docs": [ {"external_id":"gl-1001","category":"recruit",
  "title":"招聘:本地生活运营专员","content":"…"} ] }
→ {"ok":true,"total":1,"inserted":1,"errors":[]}
GET/api/tenant_ingest.php自检 → auth:true
4推送用 tenant_ingest.php,问答用 open_chat.php,共用同一把 Key
aigeo.gonglve.com.cn/api/tenant_ingest.php
开放 API · 快速接入
POST/api/tenant_ingest.php
Authorization: Bearer <你的开放 API Key>
{ "docs": [ {"external_id":"gl-1001","category":"recruit",
  "title":"招聘:本地生活运营专员","content":"…"} ] }
→ {"ok":true,"total":1,"inserted":1,"errors":[]}
GET/api/tenant_ingest.php自检 → auth:true
5带上 Key 再自检一次,看到 auth:true 即接通
以上为按步骤自动生成的界面示意图,实际界面以你的账号为准
小贴士先做自检再做对接:浏览器直接打开 <b>接口地址</b>,返回内容里有 ok:true 就说明「地址对、服务在」;带上 Key 再开一次,看到 auth:true 就说明「Key 对」。两步都过再写代码,能省掉 90% 的返工。
注意推送前请确认贵司租户的「知识库文档数」额度不小于你们的文章总量(建议 2000),否则超额的新增会被额度拦下(会在返回的 errors 里逐条说明,不会静默丢失)。