Ae · Tavily · Search

Name: Ae · Tavily · Search
Price: 6.00 USD

6.00积分/次

ae_tavily_search

使用 Tavily 搜索网络上的最新信息、新闻或事实。返回相关片段和来源 URL，并支持按日期、域名或国家/地区进行筛选。

搜索

6.00积分/次

价格说明

6.00积分/次

API 调用

通过统一工具网关发起同步请求，鉴权和计费由 AgentEarth 处理。

cURL

curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_tavily_search",
  "input": {
    "query": "xxx",
    "topic": "general",
    "country": "xxx",
    "end_date": "xxx",
    "start_date": "xxx",
    "time_range": "xxx",
    "exact_match": "xxx",
    "max_results": "5",
    "search_depth": "basic",
    "include_images": "false",
    "exclude_domains": "xxx",
    "include_domains": "xxx",
    "include_favicon": "false",
    "include_raw_content": "false",
    "include_image_descriptions": "false"
  }
}'

请求方式: POST
接口地址: /v1/tools/run
鉴权方式: Bearer Token
超时时间: 60 秒
当前版本: —

响应示例

{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数	类型	必填	说明	默认值
`query`	string	是	Search query	—
`topic`	enum (general)	否	The category of the search. This will determine which of our agents will be used for the search	general
`country`	string	否	Boost search results from a specific country. Must be a full country name (e.g., 'United States', 'Japan', 'Germany'). ISO country codes (e.g., 'us', 'jp') are not supported. Available only if topic is general. See https://docs.tavily.com/documentation/api-reference/search for the full list of supported countries.	—
`end_date`	string	否	Will return all results before the specified end date. Required to be written in the format YYYY-MM-DD	—
`start_date`	string	否	Will return all results after the specified start date. Required to be written in the format YYYY-MM-DD.	—
`time_range`	string \| null	否	The time range back from the current date to include in the search results	—
`exact_match`	boolean \| null	否	Only return results containing the exact phrase(s) in quotes in your query	—
`max_results`	integer	否	The maximum number of search results to return	5
`search_depth`	enum (basic \| advanced \| fast \| ultra-fast)	否	The depth of the search. 'basic' for generic results, 'advanced' for more thorough search, 'fast' for optimized low latency with high relevance, 'ultra-fast' for prioritizing latency above all else	basic
`include_images`	boolean	否	Include a list of query-related images in the response	false
`exclude_domains`	array	否	List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site	—
`include_domains`	array	否	A list of domains to specifically include in the search results, if the user asks to search on specific sites set this to the domain of the site	—
`include_favicon`	boolean	否	Whether to include the favicon URL for each result	false
`include_raw_content`	boolean	否	Include the cleaned and parsed HTML content of each search result	false
`include_image_descriptions`	boolean	否	Include a list of query-related images and their descriptions in the response	false