提交自然语言指令后,服务会查询相关资料,生成带有来源链接的总结和分析。本文分为意图识别和 API 使用两部分。
请求内容分为两部分:前面说明查什么,# 写作要求 后说明怎么写。
写明查询的时间、来源,以及需要关注的主题或对象。
可以直接指定 GitHub、Hugging Face、Twitter/X、YouTube,也可以使用模块名:快讯对应新闻,观点对应 Twitter/X,开源社区对应 GitHub 和 Hugging Face,传播对应 YouTube,综合总结覆盖全部来源。
多个来源或模块可以组合使用;未指定来源时,默认查询全部来源。
另起一行填写 # 写作要求,在下面说明总结、分析或比较的任务,以及目标读者、分析重点、语言、篇幅、条数等要求。没有特别要求时,可以省略这一部分,使用默认写法。
日期、来源和检索主题写在标题前;标题后只写内容分析与表达要求。
查询2026年8月22日的数据,生成综合总结。
# 写作要求
面向管理和决策人员,总结并分析当天值得关注的变化。
围绕共同主题综合多条信息,归纳1至3个关注点。
重点分析技术、产品和产业动向及其可能影响。
不要只是改写标题或罗列数字。
查找2026年8月20日至2026年8月22日与OpenAI有关的快讯。
# 写作要求
用中文总结,按事件组织内容。
最多输出5条,每条正文约100字。
表达保持客观、简洁,重点说明发生了什么变化。
查询2026年8月3日的观点模块数据,来源为Twitter/X。
# 写作要求
面向技术负责人,综合多条观点形成分析判断。
重点讨论企业采用AI的障碍及其可能影响。
最多形成3条结论,每条正文控制在120至180字。
不要机械地把每条推文改写成一条总结。
查看2026年8月7日的开源社区数据,包括GitHub与Hugging Face。
# 写作要求
比较检索结果中项目和模型的使用门槛、部署成本与生态支持。
面向开发者,用英文撰写,保持专业、简洁。
最多输出3条,每条正文不超过100个英文单词。
避免只罗列项目名称或热度数字。
获取2026年8月3日传播模块的YouTube视频数据。
# 写作要求
逐条概括视频内容,面向普通读者,用通俗中文表达。
最多输出3条,每条正文约150字。
重点说明视频讨论的核心问题,不要只是改写视频标题。
将自然语言指令放入 query。服务会自动识别来源并完成查询和分析。
curl -sS -X POST 'http://s-20260908202228-j7jhb.ailab-evobox.pjh-service.org.cn/api/v1/insight/jobs' \
-H 'Content-Type: application/json' \
-d '{
"query": "查看2026年8月7日的开源社区数据,包括GitHub与Hugging Face。\n\n# 写作要求\n面向开发者,总结并分析,最多输出3条。"
}'JSON 字符串中的 \n 表示换行。可以将上面的指令替换为第一部分的任意示例。
例如,“开源社区”会选择 GitHub 和 Hugging Face;“综合总结”会选择新闻、Twitter/X、GitHub、Hugging Face 和 YouTube。
未指定条数时最多返回 10 条有效 Insight;明确指定条数时按写作要求处理,实际数量以可支持的有效内容为准。
提交成功返回 HTTP 202,从响应的 data.job_id 取得任务 ID。202 表示任务已接受,结果需要随后查询:
{
"code": 0,
"msg": "accepted",
"trace_id": "trace_xxx",
"data": {
"job_id": "job_xxx",
"status": "queued",
"created_at": "2026-09-11T08:00:00Z"
}
}将 <job_id> 替换为提交接口返回的任务 ID:
curl -sS 'http://s-20260908202228-j7jhb.ailab-evobox.pjh-service.org.cn/api/v1/insight/jobs/<job_id>'任务状态为 queued、running、completed 或 failed。服务默认最多同时处理 5 个任务,最多另有 50 个任务按提交顺序排队(排队上限可由部署方调整)。
响应中的 created_at 是创建时间,started_at 是后台实际开始处理的时间;排队时 started_at 为 null。时间使用 UTC。
{
"code": 0,
"msg": "success",
"trace_id": "trace_xxx",
"data": {
"job_id": "job_xxx",
"status": "running",
"stage": "fetching_ai_index",
"progress": 15,
"created_at": "2026-09-11T08:00:00Z",
"started_at": "2026-09-11T08:02:00Z",
"error": null
}
}curl -sS 'http://s-20260908202228-j7jhb.ailab-evobox.pjh-service.org.cn/api/v1/insight/jobs/<job_id>/result'成功时返回 HTTP 200,Insight 位于 data.insights。任务尚未完成返回 HTTP 409;任务不存在返回 404;任务失败且无可用结果返回 422。
每条 Insight 包含 Insight ID、标题、正文和来源标题/链接。所有请求使用相同的返回结构:
{
"code": 0,
"msg": "success",
"trace_id": "trace_xxx",
"data": {
"job_id": "job_xxx",
"created_at": "2026-09-11T08:00:00Z",
"started_at": "2026-09-11T08:02:00Z",
"insights": [
{
"insight_id": "ins_001",
"title": "洞察标题",
"content": "完整的洞察正文",
"sources": [
{
"title": "来源文章或帖子的标题",
"url": "https://example.com/source"
}
]
}
]
}
}只有 failed 任务可以重试:
curl -sS -X POST 'http://s-20260908202228-j7jhb.ailab-evobox.pjh-service.org.cn/api/v1/insight/jobs/<job_id>/retry'成功接受重试返回 HTTP 202,响应结构与提交任务相同。其他状态返回 HTTP 409;任务不存在返回 404。
重试会沿用原 job_id 和原始请求参数,并生成新的 trace_id。created_at 会重置,started_at 在实际开始处理后设置。相对日期按重试执行时重新计算。
需要修改指令时,请重新提交任务。
所有接口使用 {code, msg, trace_id, data} 返回结构。接口错误的顶层 code 与 HTTP 状态码一致,例如 404、409、422;接口成功时为 0。
后台任务失败时,状态查询本身仍返回 HTTP 200,data.status 为 failed,具体原因位于 data.error:
{
"category": "source_error",
"reason": "connection_failed",
"message": "暂时无法连接数据源,请稍后重试。",
"retryable": true,
"action": "retry",
"stage": "fetching_ai_index",
"details": null
}任务错误的 category 可能为 intent_error、source_error、model_error、analysis_error、artifact_error 或 service_error;请求格式错误、任务不存在等接口错误使用 request_error。
调用方应根据 category、reason、retryable 和 action 处理,不要解析可能调整措辞的 message。反馈问题时请提供 job_id 和 trace_id。
提交任务或重试失败任务时,如果等待队列已满,接口返回 HTTP 503,顶层
code: 503、msg: queue_full,并保留统一的 trace_id、data.error 结构。
错误字段为 category: service_error、reason: queue_full、retryable: true、
action: retry_later。此时任务未被接受,不会返回新的任务 ID,也不会创建新的重试记录。
响应头 Retry-After: 30 建议等待 30 秒后重试,不保证届时一定有空位。
首次提交被拒绝时重新调用提交接口;重试被拒绝时继续使用原任务 ID 调用重试接口。