用途:通过自然语言搜索全球数据并生成图表、AI 洞察与可嵌入知识卡片,适用于数据问答、指标对比、报告配图、自有数据可视化等场景。
主要能力:知识搜索(/v1/knowledge_search)返回知识卡片,含 card_id、标题、描述、card_type、webpage_url、image_url、embed_url、relevance、sources 与 visualization_data;图表洞察(/v1/beta/chart_insights)按 card_id 返回 AI 生成的观察;数据集可视化(/v1/beta/visualize)接收 CSV 字符串数组与 query,可指定 viz_component_type(bar、pie、timeseries、choropleth、scatter、heatmap、waterfall、treemap 等);自定义卡片(/v1/thin_viz/create/)通过 components 与 config 构建;另有 /v1/thin_viz/default_schema/ 列出图表类型、/v1/tako_tools_description 获取工具说明。
使用方式:先从 ~/.gooseworks/credentials.json 读取凭据并导出 GOOSEWORKS_API_KEY 与 GOOSEWORKS_API_BASE;若文件不存在,提示用户运行 npx gooseworks login。所有端点使用 Bearer 认证,通过 $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run 代理调用,请求体指定 api 为 tako 与对应 path。知识搜索支持 inputs.text、inputs.search_effort(fast/medium/deep/auto)、source_indexes(tako、web、tako_deep_v2)、country_code、locale 及 output_settings 深色模式。
限制:资料未提供价格、配额与速率限制信息;错误码包括 400 请求无效、401 密钥无效、404 卡片未找到或无结果;结果为空时可改写查询或加入 web 来源。数据来源提及 S&P Global、World Bank 等,具体覆盖范围以实际返回为准。