向 Octen 提供问题或关键词，查找经过排序的网页结果，读取标题、来源链接和相关片段。可选择一般网页或侧重新闻，并按需缩小来源与时间范围。Agent 再依据取得的材料，另行整理带引用的简报。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Octen
向 Octen 提供问题或关键词，查找经过排序的网页结果，读取标题、来源链接和相关片段。可选择一般网页或侧重新闻，并按需缩小来源与时间范围。Agent 再依据取得的材料，另行整理带引用的简报。
你会得到与问题相关的来源页面列表，其中可包含标题、链接和有针对性的文字片段。也可请求可用网页正文或图片链接；有提供的作者与日期可帮助理解背景。Agent 再比较材料、去除重复引用，并依据实际读到的内容整理带来源的答案。
查找[w3.org]上的[网站无障碍入门指南]。最多提供[5 个有用页面]，保留网页链接和相关片段，再概括每个来源写明的要点。
搜索列表不是已完成的答案，也不是事实核查。排序不能证明页面准确或已经覆盖所有相关来源。片段和受长度限制的正文可能缺少上下文；发表日期与抓取日期代表不同事件。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
搜索请求body | object | 必填 | 必填请求对象，包含搜索词，以及按需选择的来源、时间或内容设置。
|
请求结果数量body.count | integer | 选填 | 请求1–100条结果，默认5条。它用于指定希望得到的条数，不保证存在足够多的匹配页面。
|
搜索问题或关键词body.query | string | 必填 | 必填搜索文字，长度1–500个字符。说明主题及要寻找的信息，便于获取有针对性的片段。
|
搜索主题body.topic | string | 选填 | general 用于一般网页，news 用于侧重新闻的结果，默认 general。选择新闻主题不会自动核实报道。
|
相关片段格式body.format | string | 选填 | 选择 text 或 markdown 作为相关片段格式，默认 text。这用于文字呈现，不是交互网页预览。
|
优先来源国家body.country | string | 选填 | 优先获取某个 ISO 3166 国家相关的结果。Octen 说明省略时按 auto 从问题推断优先国家；这不用于选择结果语言。 |
时间范围终点body.end_time | string | 选填 | 可选筛选范围终点，按 ISO 8601 形式填写，带上时区偏移便于明确边界。明确时间参数优先于 time_range。 |
相关片段设置body.highlight | object | 选填 | 可选对象，用于设置是否请求与问题相关的片段及其 token 长度上限。片段是来源的一部分，不是完整答案。 |
返回相关片段body.highlight.enable | boolean | 选填 | 设为 true 时请求与问题相关的片段，默认 true；任务不需要片段时可关闭。
|
片段 token 上限body.highlight.max_tokens | integer | 选填 | 每段片段可设100–20,000个 token，默认512。token 是文本处理单位，不等同于字符数或词数。
|
露骨内容筛选body.safesearch | string | 选填 | 可选 strict 或 off，默认 strict。strict 筛除露骨或成人内容，off 关闭此项筛选；它不用于判断事实可靠性。
|
时间范围起点body.start_time | string | 选填 | 可选筛选范围起点，按 ISO 8601 形式填写，并选择合适的 time_basis。明确时间参数优先于 time_range。 |
用于筛选的日期含义body.time_basis | string | 选填 | 可选 auto、published 或 crawled，默认 auto。published 按发表时间筛选，crawled 按来源抓取时间筛选，两者代表不同事件。
|
相对时间范围body.time_range | string | 选填 | 可选 day、week、month、year 或简写 d、w、m、y，依据 time_basis 从现在向前计算。明确的 start_time/end_time 优先。
|
要排除的文字body.exclude_text | array | 选填 | 可选列表，最多5项，用于排除正文中出现所给文字的页面，每项最多30个字符。按任务设置具体条件。
|
一项排除文字条件body.exclude_text[] | string | — | 一个不超过30个字符的字符串，用于指定结果页面正文中不得出现的文字。
|
网页正文设置body.full_content | object | 选填 | 可选对象，用于设置是否随结果请求网页正文，以及每条结果的 token 上限。 |
请求网页正文body.full_content.enable | boolean | 选填 | 设为 true 时随每条结果请求可用网页正文，默认 false。页面访问条件和 token 上限仍会影响可读材料。
|
正文 token 上限body.full_content.max_tokens | integer | 选填 | 每条结果的正文长度可设100–100,000个 token，默认2048。这是长度上限，不保证获取页面的每个部分。
|
要求包含的文字body.include_text | array | 选填 | 可选列表，最多5项，用于要求结果页面正文包含所给文字，每项最多30个字符。
|
一项包含文字条件body.include_text[] | string | — | 一个不超过30个字符的字符串，用于指定结果页面正文必须包含的文字。
|
附带图片链接body.include_images | boolean | 选填 | 设为 true 时请求随结果附带可用图片链接，默认 false；链接不等于已经读取或保存的图片文件。
|
排除域名列表body.exclude_domains | array | 选填 | 可选列表，最多1200个排除域名，每项最多60个字符。Octen 的 Search 参考说明，同一域名同时包含和排除时，排除优先。
|
一个排除域名body.exclude_domains[] | string | — | 一个不超过60个字符的域名字符串，用于从来源列表中排除该域名。
|
包含域名列表body.include_domains | array | 选填 | 可选列表，最多1200个包含域名，每项最多60个字符。请填写域名，不是文章的完整链接。
|
一个包含域名body.include_domains[] | string | — | 一个不超过60个字符的域名字符串，用于指定要包含的来源域名。
|
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"count": {
"type": "integer",
"default": 5,
"maximum": 100,
"minimum": 1,
"description": "返回结果数量，范围 1 至 100。"
},
"query": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "搜索词。"
},
"topic": {
"enum": [
"general",
"news"
],
"type": "string",
"default": "general",
"description": "general 为一般网页搜索，news 为新闻搜索。"
},
"format": {
"enum": [
"markdown",
"text"
],
"type": "string",
"default": "text",
"description": "相关片段的输出格式。"
},
"country": {
"type": "string",
"description": "优先搜索的 ISO 3166 国家代码；默认 auto 从问题推断。"
},
"end_time": {
"type": "string",
"description": "筛选结果的结束时间，格式为 ISO 8601。"
},
"highlight": {
"type": "object",
"properties": {
"enable": {
"type": "boolean",
"default": true,
"description": "为 true 时，每条结果返回与查询相关的片段。"
},
"max_tokens": {
"type": "integer",
"default": 512,
"maximum": 20000,
"minimum": 100,
"description": "每段相关片段的最多 tokens 数量。"
}
},
"additionalProperties": false
},
"safesearch": {
"enum": [
"off",
"strict"
],
"type": "string",
"default": "strict",
"description": "成人或露骨内容筛选。"
},
"start_time": {
"type": "string",
"description": "筛选结果的开始时间，格式为 ISO 8601。"
},
"time_basis": {
"enum": [
"auto",
"published",
"crawled"
],
"type": "string",
"default": "auto",
"description": "用于时间筛选的时间字段。"
},
"time_range": {
"enum": [
"day",
"week",
"month",
"year",
"d",
"w",
"m",
"y"
],
"type": "string",
"description": "从现在向前计算的相对时间范围，与 start_time/end_time 互斥；明确时间参数优先。"
},
"exclude_text": {
"type": "array",
"items": {
"type": "string",
"maxLength": 30
},
"maxItems": 5,
"description": "结果页面正文中不得出现的字符串。"
},
"full_content": {
"type": "object",
"properties": {
"enable": {
"type": "boolean",
"default": false,
"description": "为 true 时，每条结果返回 full_content。"
},
"max_tokens": {
"type": "integer",
"default": 2048,
"maximum": 100000,
"minimum": 100,
"description": "每条结果完整内容的最多 tokens 数量。"
}
},
"additionalProperties": false
},
"include_text": {
"type": "array",
"items": {
"type": "string",
"maxLength": 30
},
"maxItems": 5,
"description": "结果页面正文中必须出现的字符串。"
},
"include_images": {
"type": "boolean",
"default": false,
"description": "是否在每条结果中包含图片。"
},
"exclude_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"maxItems": 1200,
"description": "搜索结果明确排除的域名。"
},
"include_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"maxItems": 1200,
"description": "搜索结果明确包含的域名。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
将结果当作来源列表来读。位置靠前体现的是 Octen 的搜索排序，不是对页面说法的独立确认。使用片段时，保留对应标题与链接。不同页面可能重复同一说法，Agent 可另行比较来源并去除重复引用。
相关片段默认开启，用于围绕问题挑选有用文字，不能代表页面的全部内容。网页正文是另一个可选请求，默认关闭；未另选支持的长度时，每条结果最多2048个 token。长度上限可能使部分重要上下文没有进入返回文字。
时间筛选既要设置范围，也要选择日期含义。published 指发表时间，crawled 指来源抓取时间。Octen 的 Search 参考说明，缺少所用日期字段的结果会在时间筛选时被排除。明确起止时间优先于 time_range；旧文章最近被抓取，仍然是旧文章。
用域名和文字条件缩小阅读范围。Octen 的 Search 参考说明，同一域名同时包含和排除时，排除优先。country 用于优先获取某个国家相关的来源，不是语言限制。条件较窄时，可用列表可能减少；请求条数不能证明覆盖完整。
有提供时，保留作者、发表日期与抓取日期；缺少日期时，不用请求时间代替。可选图片是与结果关联的链接，读取图片文件需要另行完成。摘要、翻译、比较和事实核对，由 Agent 依据实际拿到的材料开展。
可要求最多[5 个页面]，优先查看[w3.org]，或跳过提到[某个词语]的页面。需要近期内容时，可以说[过去一个月发布的网页]。快速浏览时看[重点片段]；需要更多上下文时，可要求[更多网页正文]。
查找[w3.org]上的[网站无障碍入门指南]。最多提供[5 个有用页面]，保留网页链接和相关片段，再概括每个来源写明的要点。
使用前先查看每个页面的标题、链接和相关片段。有日期或作者时，把它与对应来源放在一起。AI 助手可以比较页面内容、整理带链接的摘要，并指出缺少的信息或无法读取的页面。
相关片段是与问题有关的选取文字。保留来源链接，只引用实际提供的段落。若结论依赖更广的内容，可请求可用正文或另行打开来源。Agent 应区分取得的原文与自己的解读。
Octen 的 Search 参考说明，缺少所用日期字段的结果会在时间筛选时被排除。发表时间和抓取时间不同，应选择符合问题的日期含义。没出现在结果中，不代表该页面从未发表或已经删除。
Octen 的 Search 参考说明，同一域名的 exclude_domains 优先于 include_domains。设置列表时，让它们与实际要读取的来源一致。来源或文字条件较窄时，可用结果可能少于请求数量。
country 用于优先获取某个国家相关的结果，不是语言选择器。侧重某国的搜索仍可能包含不同语言的页面。需要时，Agent 可识别取得的文字语言并另行翻译，同时保留原文供核对。