Tavily Research
根据问题生成带来源的研究报告,支持模型、引用格式、报告长度、域名偏好、结构化输出和附件。本工具异步执行:先返回AE任务ID,再通过ae_get_result查询;查询同一任务不会重新提交研究。预占按所选模型官方上限,最终按实际用量结算。
Pricing
The charge per call is (max(6 × Actual research usage, 0)) AE credits. All applicable conditions are combined to calculate the total.
Charges vary with the selected research model and the task's actual research usage. Available models are mini, pro, and auto; the default is auto. Each research task is charged once upon completion. Repeated queries for the same task do not resubmit the research or incur additional charges. Zero actual usage incurs no charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
files | array | No | 研究使用的附件,包含文件名及base64内容;最多5个文件。 | — |
files[].data | string | Yes | The base64-encoded file contents. | — |
files[].name | string | Yes | The filename, including its extension (`.txt`, `.md`, or `.json`). | — |
files[].type | enum (base64) | No | The encoding of the `data` field. | base64 |
input | string | Yes | 要研究的问题,尽量写明范围和输出要求。 | — |
model | enum (mini | pro | auto) | No | 研究模型:mini、pro或auto。 | auto |
output_length | enum (short | standard | long) | No | 报告长度目标,不是严格字数上限。 | standard |
output_schema | object | No | 研究结果的JSON Schema,需包含properties。 | — |
output_schema.required | array | No | An array of property names that are required. At least one key from the properties object must be included. | — |
output_schema.properties | object | No | An object containing property definitions. Each key is a property name, and each value is a property schema. | — |
citation_format | enum (numbered | mla | apa | chicago) | No | 研究报告的引用格式。 | numbered |
exclude_domains | array | No | 排除的域名列表。 | [] |
include_domains | array | No | 优先或限定检索的域名列表,具体约束取决于include_domains_mode。 | [] |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tavily_research' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"include_domains": [
"docs.python.org"
],
"input": "In at most 150 words, explain how Python asyncio.TaskGroup cancels sibling tasks when a child raises an exception. Cite the official Python documentation.",
"model": "mini",
"output_length": "short"
}
}'{
"description": "task accepted; poll the result via query_tool with this task_id",
"query_tool": "ae_get_result",
"status": "created",
"task_id": "c0e462fa-24bc-4a4e-a907-fe0224e1af35"
}This example shows part of the response. Copied content is valid JSON.





