Web Search Skill 指导开发者使用 z-ai-web-dev-sdk 包实现网页搜索功能,使应用能够检索互联网并获取当前信息。
用途:为应用或脚本增加实时网页搜索能力,获取新闻、技术资料、研究信息等当前数据。
主要能力:调用 web_search 函数,参数包括 query(必填,搜索关键词)、num(可选,结果数量,默认 10)、recency_days(可选,仅返回最近 N 天的结果)。每条结果包含 url、name(标题)、snippet(摘要)、host_name(域名)、rank(排名)、date(发布日期)、favicon。
使用方式:
- 安装路径:建议将技能包解压到 {project_path}/skills/web-search;参考脚本位于 {project_path}/skills/web-search/scripts/,示例见 web_search.ts。
- CLI 方式:适合快速查询与简单自动化,例如 z-ai function --name "web_search" --args '{"query": "artificial intelligence"}',可用 -n、-a、-o 简写与输出文件参数。
- SDK 方式:适合应用内动态搜索、多步骤流程、自定义结果处理与生产环境复杂逻辑。示例代码通过 ZAI.create() 初始化,再调用 zai.functions.invoke('web_search', { query, num })。
重要限制:z-ai-web-dev-sdk 必须仅在后端代码中使用,禁止用于客户端代码。前提是该包已安装。
适用场景:实时信息检索、新闻搜索、研究助手、主题对比、搜索结果质量校验、缓存与限流等。资料提供了格式化结果、按域名过滤分组、按日期排序、重试与指数退避、结果缓存、每分钟请求限流等示例实现。
资料未提及该技能的收费、价格或具体性能指标。