一、这个接口做什么
把你们系统里的文章、招聘、商家、分类信息、便民指南、新闻资讯等批量写进小鸥的知识库,让小鸥「答得出你们自己的内容」。按 external_id 去重:同一篇再次推送 = 更新,不会重复入库。
二、请求格式
POST https://aigeo.gonglve.com.cn/api/tenant_ingest.php
Authorization: Bearer <你的开放 API Key>
Content-Type: application/json
{
"docs": [
{"external_id":"gl-news-1001","category":"news","title":"……","content":"……","status":"published"},
{"external_id":"gl-job-22","category":"recruit","title":"招聘:本地生活运营专员","content":"……"},
{"external_id":"gl-shop-7","category":"merchant","title":"某某汽修 · 24 小时道路救援","content":"……"}
]
}
三、返回值怎么读
{"ok":true,"total":3,"inserted":3,"updated":0,"skipped":0,
"errors":[],"tenant":12,"hint":"入库内容会立即参与小鸥问答(缓存已刷新)。"}
| 字段 | 含义 |
| inserted | 新增条数 |
| updated | 命中同一 external_id,已更新(不新增) |
| skipped | 跳过条数(缺标题与正文、超额度的新增等) |
| errors[] | 逐条说明第几条为什么被跳过,例如「docs[3] 知识库文档额度不足(上限 2000),已跳过新增」 |
| truncated | 正文超 200KB 被截断的条数(有才出现) |
四、字段与分类怎么填(都做了兼容,任选一种写法)
| 项 | 可接受的写法 |
| 数组字段名 | docs / articles / items / data / list / contents;也支持只推一篇,或 {"doc":{…}} |
| 标题 | title / name / subject / headline |
| 正文 | content / body / text / desc / description / summary / detail |
| 去重键 | external_id / ext_id / doc_id / source_id / id(建议用你们自己的文章 / 商家 ID) |
| 分类 | category / cat / type / channel / column;招聘、商家、分类信息、便民指南、新闻资讯统一归入知识库「新闻」类,原始分类名会保留(供检索加权) |
| 链接 | url / link / href(作为正文末尾「原文链接」保留,方便小鸥回答时给出处) |
| 鉴权方式 | Authorization: Bearer <Key> / X-Api-Key: <Key> / ?key=<Key> / body 里带 api_key,四种任选其一 |
五、批量与节奏
- 单次最多 1000 条;上千篇建议每批不超过 200 条、多次调用(接口按 external_id 幂等,断点重推不会重复)。
- 单篇正文上限 200KB,超出会截断并在返回里给出 truncated 计数。
- 推送成功后自动刷新该租户的小鸥答案缓存,内容立刻可被问到,不用等缓存过期。
六、自检(务必先做这一步)
# ① 不带头:确认接口在不在
curl "https://aigeo.gonglve.com.cn/api/tenant_ingest.php"
# → {"ok":true,"service":"tenant_ingest","version":86,"auth":false,...}
# ② 带上 Key:确认 Key 对不对
curl -H "Authorization: Bearer <你的Key>" "https://aigeo.gonglve.com.cn/api/tenant_ingest.php"
# → {"ok":true,"service":"tenant_ingest","auth":true,"tenant":12,...}
1确认接口在
2确认 Key 有效
3先推 1 条测试
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浏览器打开 /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
2带 Authorization Bearer 再打开一次,看到 auth: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
3POST 一条招聘,看返回 inserted 是否为 1
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每批 200 条,按 external_id 幂等,可断点重推
aigeo.gonglve.com.cn/tenant
吉易鸥
工作台总览
企业基础信息
企业知识库
官网产品信息库
官网企业案例库
新闻资讯库
关键词词包
AI 文章创作
信源发布
AI 数字官网
AI 视频创作
小鸥聊天
Agent 数字员工
数据报告
小鸥聊天
我的资料完整度怎么样?
你的企业资料完整度 82%:还缺「核心资源与资质」。补齐后 AI 生成文章的专业度会更高,要我帮你列一份清单吗?
围绕"工业清洗设备"给我 5 个选题
① 工业清洗设备怎么选…(正在生成)
5在你们页面上问「有哪些招聘」,小鸥应能答出刚推的内容
注意最常见的坑:把「环境域名」填成了完整接口地址(例如 …/api/open_chat.php),于是同步地址被拼成 …/open_chat.php/api/tenant_ingest.php。新版已做「串门容错」,会自动把它转交给同步接口,但建议仍把环境域名改回纯域名,最干净。