联网问答Agent
URL | 本接口仅支持API Key接入:https://open.feedcoopapi.com/agent_api/agent/collab |
URL | 本接口仅支持API Key接入:https://open.feedcoopapi.com/agent_api/agent/collab |
Method | POST |
Header |
|
段名(一级) | 字段名(二级) | 类型 | 必须 | 说明 |
段名(一级) | 字段名(二级) | 类型 | 必须 | 说明 |
Query | | String | 是 | 用户搜索query,1~100个字符(过长会截断),不支持多词搜索 |
Count | | Number | 否 | 返回条数,最多50条,默认10条 |
EnableWaiting | | Boolean | 否 | 是否开启队列模式
|
MaxWaitTime | | Number | 否 | 队列模式开启后,超出QPS限制的请求在队列中等待的最大时间(毫秒),最大10000(毫秒),默认5000(毫秒) |
Filter | | Object | 否 | 过滤条件 |
| NeedContent | Boolean | 否 | 是否仅返回有正文的结果,默认false(不限制必须有正文) |
| NeedUrl | Boolean | 否 | 是否仅返回原文链接的结果
|
| Sites | String | 否 | 指定搜索的站点范围,多个站点使用'|'分隔,最多支持20个。 需填入完整域名,示例:aliyun.com|mp.qq.com |
| BlockHosts | String | 否 | 指定屏蔽的搜索Site,多个域名使用'|'分隔,最多支持20个。 需填入完整域名,示例:aliyun.com|mp.qq.com |
| AuthInfoLevel | Number | 否 | 指定仅在非常权威内容范围内搜索,默认为0 0:不限制搜索结果的权威等级 1:限制搜索结果为【非常权威】(搜索结果会减少) |
| IcpHostOnly | Boolean | 否 | 是否限制仅在国内ICP备案的网站中搜索
|
TimeRange | | String | 否 | 指定搜索的发文时间。 以下枚举值,不填即为不限制
|
QueryControl | | | | |
| QueryRewrite | Boolean | 否 | 是否开启Query改写(开启后会增加搜索耗时),默认false(不开启) |
ContentFormats | | String | 否 | 指定返回正文的格式,默认为Text
|
Industry | | String | 否 | 执行行业类型搜索,支持
(执行行业搜索时,搜索结果会减少,并过滤掉如意结果) |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
ResultCount | Number | 是 | 搜索到的结果数 |
WebResults | Array[WebItem] | 否 | 返回的搜索列表,结构见WebItem |
Choices | Array[Choice] | 否 | 流式响应内容 |
Usage | Usage | 否 | Token和时间消耗量 |
SearchContext | SearchContext | 是 | 搜索上下文信息,结构见WebItem,SearchContext. 主要包含原始Query、SearchType等信息 |
TimeCost | Number | 是 | 耗时,毫秒 |
LogId | String | 是 | 日志Id,和Response Header中的X-Tt-Logid相同 |
CardResults | Array | 否 |
字段名(一级) | 字段名(二级) | 类型 | 必须 | 说明 |
字段名(一级) | 字段名(二级) | 类型 | 必须 | 说明 |
Id | | String | 是 | 结果Id |
SortId | | Number | 是 | 排序Id |
Title | | String | 是 | 标题 |
SiteName | | String | 否 | 站点名 |
Url | | String | 否 | 落地页 |
Snippet | | String | 是 | 简短片段(约200字) 字数限制导致缺失相关信息,仅建议用于搜索结果的列表展示,强烈不建议用于大模型场景。 |
Summary | | String | 否 | 相关摘要:搜索结果正文中和query相关的片段(500~1000字) 同时考虑内容完整性和字数长度,推荐用于大模型场景 |
Content | | String | 否 | 正文(引用站点正文) |
PublishTime | | String | 否 | 发布时间,ISO时间格式 示例:2025-05-30T19:35:24+08:00 |
LogoUrl | | String | 否 | 落地页IconUrl链接 |
RankScore | | Float | 否 | 得分 |
AuthInfoDes | | String | 是 | 权威度描述,包括:非常权威、正常权威、一般权威、一般不权威 |
AuthInfoLevel | | Number | 是 | 权威度评级,对应权威度描述,包括:1 非常权威、2 正常权威、3 一般权威、4 一般不权威 |
ContentFormats | | String | 否 | 实际返回的正文格式
|
InlineImages | | Array[InlineImage] | 否 | 网页中的插图信息(仅部分权威网站的网页包含) |
AuthorInfo | | | | |
| Name | String | 否 | 文章作者名称,当前仅覆盖 今日头条、新浪新闻 等站点。 |
RuyiInfo | | | 否 | 仅当Sitename=“火山如意”时有值 |
| Type | String | 否 | WebItem形式的 火山如意 结果类型,包含以下值:
|
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
Width | String | 是 | 图片宽度 |
Height | Number | 是 | 图片高度 |
ImageUrl | Number | 是 | 图片链接 |
Alt | String | 否 | 图片内容描述 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
Delta | Object | 否 | 流式响应。包含增量更新内容
|
Message | Object | 否 | 无实际意义 |
FinishReason | String | 是 | 生成终止的原因,可能的值:
|
Index | Number | 是 | 当前选择的索引编号。在单个响应中通常为 0,在多选择配置下可能有多个索引 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
PromptTokens | Number | 是 | 本次请求中模型输入 token 数量(包含意图、改写、总结等环节) |
CompletionTokens | Number | 是 | 本次请求中模型输出的 token 数量(包含意图、改写、总结等环节) |
TotalTokens | Number | 是 | 本次请求消耗的总 token 数量(输入 + 输出) |
SearchTimeCost | Number | 是 | 本次请求搜索耗时 |
FirstTokenTimeCost | Number | 是 | 本次请求首帧耗时 |
TotalTimeCost | Number | 是 | 本次请求全部耗时 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
SearchType | String | 是 | 搜索类型枚举值,目前支持"web" |
OriginQuery | String | 是 | 原始Query |
字段名 | 卡片类型 | 必须 | 说明 |
字段名 | 卡片类型 | 必须 | 说明 |
CardType | 卡片类型 | 是 | |
WeatherCard | 天气 | 否 | 固定日期及未来天气、空气质量、生活指数、城市天气 |
LotteryCard | 彩票 | 否 | 彩票开奖结果 |
MetalCard | 贵金属 | 否 | 贵金属价格趋势 |
ExchangeRateCard | 汇率 | 否 | 汇率换算 |
HolidayCard | 节假日 | 否 | 节假日信息 |
HanziCard | 汉字 | 否 | 汉字的拼音、结构、笔顺、释义 |
ZodiacDetailCard | 生肖运势 | 否 | 生效当日、当月、当年的运势解读 |
TrainScheduleCard | 火车车次详情 | 否 | 按车次查询火车站点、时间信息 |
TrainRouteCard | 两地火车 | 否 | 两地之间火车车次、站点、票价信息 |
FlightRouteCard | 两地航班 | 否 | 两地之间航班、时间、票价信息 |
ConcertCityCard | 城市演唱会 | 否 | 城市近期演唱会信息 |
URL |
|
URL |
|
Method | POST |
Header |
|
字段名(一级) | 字段名(二级) | 类型 | 必须 | 默认值 | 说明 |
字段名(一级) | 字段名(二级) | 类型 | 必须 | 默认值 | 说明 |
Query | | String | 是 | - | 用户搜索query,1~100个字符(过长会截断),不支持多词搜索 |
EnableWaiting | | Boolean | 否 | | 是否开启队列模式
|
MaxWaitTime | | Number | 否 | | 队列模式开启后,超出QPS限制的请求在队列中等待的最大时间(毫秒),最大10000(毫秒),默认5000(毫秒) |
DocCount | | Number | 否 | 10 | 返回结果条数,最多20条,默认10条 数量增加会增加搜索耗时 不等同于响应中的 TotalDocCount |
MaxSnippetLength | | Number | 否 | 500 | 单个摘要片段的最大tokens,传入值 > 0 时生效,最大3000,推荐1000以内 |
MaxImageCountPerDoc | | Number | 否 | 3 | 单条搜索结果最多返回的图片数量,传入值 > 0 时生效,最多10个,默认3个 |
Filter | | | | | |
| IcpHostOnly | Boolean | 否 | false | 是否限制仅在国内ICP备案的网站中搜索
|
字段名 | 类型 | 出现阶段 | 必须 | 说明 |
字段名 | 类型 | 出现阶段 | 必须 | 说明 |
TotalDocCount | Number | 首帧(搜索结果) | 是 | 下游返回的总命中文档数,不等同于 Documents 实际返回条数。 |
Documents | Array[GlobalSearchDocument] | 首帧(搜索结果) | 否 | 本次返回的网页文档列表,数量受 DocCount 控制。 |
ErrorCode | Number | 首帧(搜索结果) | 是 | 检索源业务错误码。为 0 表示检索成功;非 0 时应读取 ErrorMsg,且不会继续返回总结。 |
ErrorMsg | String | 首帧(搜索结果) | 是 | 检索源业务错误信息。 |
Choices | Array[Choice] | 过程帧(总结流式) | 是 | 总结输出,当前仅返回下标为 0 的 Choice。 |
Usage | Usage | 最终帧 | 是 | 总结完成后的 token 与耗时统计。 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
Rank | Number | 是 | 排序位置(由0开始) |
Url | String | 否 | 搜索结果落地页URL |
Title | String | 否 | 搜索结果标题 |
Snippet | Array[GlobalSearchSnippet] | 否 | 相关摘要:搜索结果正文中和query相关的片段,长度由Request中的 [MaxSnippetLength] 决定, |
DocumentInfo | GlobalSearchDocumentInfo | 否 | 结果统计与类型信息 |
HostInfo | GlobalSearchHostInfo | 否 | 站点信息,当SearchType=web时有值 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
Type | String | 否 | 摘要类型,包括:text、image |
Text | String | 否 | 文本摘要,仅 Type = text 时返回 |
Image | GlobalSearchSnippetImage | 否 | 网页插图 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
Width | Number | 否 | 图片宽度 |
Height | Number | 否 | 图片高度 |
ImageUrl | String | 否 | 图片地址 |
Alt | String | 否 | 图片替代文本,当SearchType=image时有值。 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
ContentCharCount | Number | 否 | 正文字符数 |
ContentTokenCount | Number | 否 | 正文 token 数 |
Filetype | String | 否 | 搜索结果类型,包括:webpage、pdf、image |
PublishTime | String | 否 | 网页发布时间 |
字段名 | 类型 | 说明 |
字段名 | 类型 | 说明 |
HostInfo.Hostname | String | 站点 Hostname。 |
HostInfo.IconUrl | String | 站点 Icon URL。 |
HostInfo.AuthorityLevel | String | 站点权威等级:very_high、high、normal; |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
Delta | Object | 否 | 流式响应,当前为 assistant。 |
Message | Object | 否 | 无实际意义 |
FinishReason | String | 是 | 生成终止的原因,可能的值:
|
Index | Number | 是 | 当前选择的索引编号。在单个响应中通常为 0,在多选择配置下可能有多个索引 |
字段名 | 类型 | 必须 | 说明 |
字段名 | 类型 | 必须 | 说明 |
PromptTokens | Number | 是 | 本次请求中模型输入 token 数量(包含意图、改写、总结等环节) |
CompletionTokens | Number | 是 | 本次请求中模型输出的 token 数量(包含意图、改写、总结等环节) |
TotalTokens | Number | 是 | 本次请求消耗的总 token 数量(输入 + 输出) |
SearchTimeCost | Number | 是 | 本次请求搜索耗时 |
FirstTokenTimeCost | Number | 是 | 本次请求首帧耗时 |
TotalTimeCost | Number | 是 | 本次请求全部耗时 |
错误码 | 说明 | 建议检查/处理方式 |