大模型回答
获取大模型回答记录列表
- 请求方法:POST
- 请求路径:
/geo/task/get
说明:传入 include_unanalyzed=true 可包含分析中的、需要处理或暂无可用分析的回答;默认只返回已完成分析的结果。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| begin_date | string | 开始日期,格式:YYYY-MM-DD | 是 |
| end_date | string | 结束日期,格式:YYYY-MM-DD | 是 |
| include | int | 提示词筛选方式:0-不包含,1-包含 | 否 |
| prompt | string | 用户提问关键字 | 否 |
| title_id | string 数组 | 提示词标题ID列表 | 否 |
| prompt_ids | string 数组 | 提示词ID列表 | 否 |
| tag_ids | string 数组 | 标签ID列表 | 否 |
| task_ids | string 数组 | 任务ID列表 | 否 |
| platforms | string 数组 | 大模型平台列表 | 否 |
| language | string 数组 | 语言列表 | 否 |
| mention_brand | int | 是否提及品牌筛选:-1-全部,0-未提及,1-提及 | 否 |
| min_score | int | 最小分数 | 否 |
| max_score | int | 最大分数 | 否 |
| include_unanalyzed | bool | 是否包含尚未完成分析的回答,默认 false | 否 |
| url | string | 引用链接URL过滤 | 否 |
| ref_platform | string | 引用来源域名过滤(兼容旧参数) | 否 |
| article_id | string | 文章ID过滤 | 否 |
| page | int | 页码 | 否 |
| page_size | int | 每页数量 | 否 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| scores | object 数组 | 大模型回答记录列表 |
| scores.task_id | string | 任务ID |
| scores.query_id | string | 提示词ID |
| scores.query_str | string | 提示词内容 |
| scores.platform | string | 大模型平台 |
| scores.language | string | 语言 |
| scores.zone | string | 地区 |
| scores.date | string | 任务日期 |
| scores.exposure | int | 是否提及品牌:0-未提及,1-提及 |
| scores.score | int | 品牌曝光度评分 |
| scores.avg_rank | int | 品牌排名,0 表示未提及 |
| scores.title_id | string | 提示词标题ID |
| scores.title_name | string | 提示词标题名称 |
| scores.trace_article_cnt | int | 追踪文章引用数量 |
| scores.tags | object 数组 | 提示词关联标签 |
| scores.tags.tag_id | string | 标签ID |
| scores.tags.tag_name | string | 标签名称 |
| scores.tags.tag_type | int | 标签类型:1-用户,2-系统,3-大模型 |
| scores.analysis | object | 分析状态与指标(有数据时返回) |
| scores.analysis.state | int | 0未知;1分析中;2分析完成;3需要处理;4无可用分析 |
| scores.analysis.action_reason | int | state=3 时的原因:0未知;1积分不足 |
| scores.analysis.metrics | object | 分析指标,仅 state=2 时返回 |
| scores.analysis.metrics.exposure / score / rank / exposure_count | int | 提及标记、分数、排名和提及次数 |
| total | int | 总数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"scores": [
{
"task_id": "task_test_001",
"prompt_id": "prompt_test_001",
"query_str": "测试品牌A适合哪些业务场景?",
"platform": "test-llm",
"language": "zh",
"zone": "CN",
"date": "2026-01-15",
"exposure": 1,
"score": 86,
"avg_rank": 2,
"title_id": "title_test_001",
"title_name": "测试分类A",
"trace_article_cnt": 3,
"tags": [
{
"tag_id": "tag_test_001",
"tag_name": "测试标签A",
"tag_type": 1
}
],
"analysis": {
"state": 2,
"action_reason": 0,
"metrics": {
"exposure": 1,
"score": 86,
"rank": 2,
"exposure_count": 1
}
}
}
],
"total": 1
}
}获取大模型回答记录详情
- 请求方法:POST
- 请求路径:
/geo/task/detail/get
说明:analysis 对象用于表示分析状态、处理原因及可用的分析指标。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
| brand_id | string | 品牌ID | 是 |
| task_id | string | 任务ID | 是 |
响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
| query | string | 提示词内容 |
| query_id | string | 提示词ID |
| score | int | 品牌曝光度评分 |
| zone | string | 地区 |
| language | string | 语言 |
| exposure | int | 是否提及品牌:0-未提及,1-提及 |
| rank | int | 品牌排名,0 表示未提及 |
| exposure_cnt | int | 品牌提及次数 |
| llm_output | string | 大模型回答原文 |
| platform | string | 大模型平台 |
| date | string | 任务日期 |
| links | object 数组 | 引用链接列表 |
| links.index | int | 引用序号 |
| links.url | string | 引用链接URL |
| links.title | string | 引用链接标题 |
| links.source | int | 引用来源类型:0-未关联追踪文章/未知,1-平台创作,2-用户创作,3-官网文章 |
| links.article_id | string | 关联追踪文章ID |
| pic | string 数组 | 图片链接列表 |
| fanout | object 数组 | 扩展信息列表 |
| recommend_queries | string 数组 | 推荐提示词列表 |
| video_cards | object 数组 | 视频卡片列表 |
| video_cards.id | string | 视频卡片ID |
| video_cards.video_title | string | 视频标题 |
| video_cards.source_name | string | 来源名称 |
| video_cards.video_description | string | 视频描述 |
| video_cards.video_link | string | 视频链接 |
| video_cards.sort_index | int | 排序序号 |
| video_cards.cover_url | string | 封面图链接 |
| product_cards | object 数组 | 商品卡片列表 |
| product_cards.id | string | 商品卡片ID |
| product_cards.product_name | string | 商品名称 |
| product_cards.product_price | string | 商品价格 |
| product_cards.product_image | string | 商品图片 |
| product_cards.product_link | string | 商品链接 |
| product_cards.product_description | string | 商品描述 |
| product_cards.platform | string | 商品平台 |
| product_cards.sort_index | int | 排序序号 |
| title_name | string | 提示词标题名称 |
| title_id | string | 提示词标题ID |
| tags | object 数组 | 提示词关联标签 |
| tags.tag_id | string | 标签ID |
| tags.tag_name | string | 标签名称 |
| tags.tag_type | int | 标签类型:1-用户,2-系统,3-大模型 |
| analysis | object | 分析状态与指标(有数据时返回) |
| analysis.state | int | 0未知;1分析中;2分析完成;3需要处理;4无可用分析 |
| analysis.action_reason | int | state=3 时的原因:0未知;1积分不足 |
| analysis.metrics | object | 分析指标,仅 state=2 时返回 |
| analysis.metrics.exposure / score / rank / exposure_count | int | 提及标记、分数、排名和提及次数 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {
"prompt": "测试品牌A适合哪些业务场景?",
"prompt_id": "prompt_test_001",
"score": 86,
"zone": "CN",
"language": "zh",
"exposure": 1,
"rank": 2,
"exposure_cnt": 1,
"llm_output": "测试品牌A适用于场景一、场景二与场景三。",
"platform": "test-llm",
"date": "2026-01-15",
"links": [
{
"index": 1,
"url": "https://example.com/articles/test-article-1",
"title": "测试文章一",
"source": 1,
"article_id": "article_test_001"
}
],
"pic": [
"https://example.com/images/test-image-1.png"
],
"fanout": [],
"recommend_queries": [
"测试品牌A的核心优势是什么?"
],
"analysis": {
"state": 2,
"action_reason": 0,
"metrics": {
"exposure": 1,
"score": 86,
"rank": 2,
"exposure_count": 1
}
},
"video_cards": [
{
"id": "video_card_test_001",
"video_title": "测试视频一",
"source_name": "测试来源",
"video_description": "测试视频描述",
"video_link": "https://example.com/videos/test-video-1",
"sort_index": 1,
"cover_url": "https://example.com/images/video-cover-1.png"
}
],
"product_cards": [
{
"id": "product_card_test_001",
"product_name": "测试商品一",
"product_price": "99.00",
"product_image": "https://example.com/images/product-1.png",
"product_link": "https://example.com/products/test-product-1",
"product_description": "测试商品描述",
"platform": "test-platform",
"sort_index": 1
}
],
"title_name": "测试分类A",
"title_id": "title_test_001",
"tags": [
{
"tag_id": "tag_test_001",
"tag_name": "测试标签A",
"tag_type": 1
}
]
}
}手动再次运行用户提问
- 请求方法:POST
- 请求路径:
/geo/prompt/run
说明:run_count 表示每个提问当天额外运行的次数。共享副本提问不支持手动运行;运行结果通过获取大模型回答记录列表查询。
请求参数:
| 入参 | 类型 | 含义 | 是否必填 |
|---|---|---|---|
brand_id | string | 品牌 ID | 是 |
prompt_ids | string 数组 | 要运行的已启用提问 ID | 是 |
run_count | int | 每个提问额外运行次数;接口接受大于 0 的整数,控制台当前选项为 1–5 | 是 |
请求示例:
{
"brand_id": "1001",
"prompt_ids": [
"3001"
],
"run_count": 1
}响应参数:
| 返回值 | 类型 | 含义 |
|---|---|---|
code | int | 0 表示成功 |
msg | string | 返回消息 |
data | object | 成功时为空对象 |
响应示例:
{
"code": 0,
"msg": "success",
"data": {}
}