From 455247826e9da5d1a171a79565b7a1c4a71d2da9 Mon Sep 17 00:00:00 2001 From: Eric Liu <45324290+25eliu@users.noreply.github.com> Date: Mon, 3 Aug 2026 15:03:44 -0700 Subject: [PATCH 1/2] docs: add Tako community provider Documents @takoviz/ai-sdk, which integrates Tako's live-data search (knowledge cards, synthesized answers, and underlying row export) with the AI SDK as a set of tools. --- .../02-providers-and-models.mdx | 1 + .../05-community-providers/53-tako.mdx | 265 ++++++++++++++++++ 2 files changed, 266 insertions(+) create mode 100644 content/providers/05-community-providers/53-tako.mdx diff --git a/content/docs/02-foundations/02-providers-and-models.mdx b/content/docs/02-foundations/02-providers-and-models.mdx index dd639be34139..9d18c0fcd626 100644 --- a/content/docs/02-foundations/02-providers-and-models.mdx +++ b/content/docs/02-foundations/02-providers-and-models.mdx @@ -96,6 +96,7 @@ The open-source community has created the following providers: - [OLLM Provider](/providers/community-providers/ollm) (`@ofoundation/ollm`) - [ZeroEntropy Provider](/providers/community-providers/zeroentropy) (`zeroentropy-ai-provider`) - [Neon AI Gateway Provider](/providers/community-providers/neon-ai-gateway) (`@neon/ai-sdk-provider`) +- [Tako Provider](/providers/community-providers/tako) (`@takoviz/ai-sdk`) ## Self-Hosted Models diff --git a/content/providers/05-community-providers/53-tako.mdx b/content/providers/05-community-providers/53-tako.mdx new file mode 100644 index 000000000000..a950c1c47efa --- /dev/null +++ b/content/providers/05-community-providers/53-tako.mdx @@ -0,0 +1,265 @@ +--- +title: Tako +description: Learn how to use Tako with the AI SDK. +--- + +# Tako + +[Tako](https://tako.com) is a live-data search engine. A single call searches both the live web +and Tako's own structured data, returning web results alongside knowledge cards — charts and +metrics that carry their sources and freshness metadata. The +[`@takoviz/ai-sdk`](https://www.npmjs.com/package/@takoviz/ai-sdk) package integrates Tako with +the AI SDK as a set of tools. + +It covers what a web search tool covers, and adds a structured layer on top. For a question +that turns on a number, you get the value, the source it came from, how current it is, and a +chart you can render — instead of prose to parse. That layer is deepest in: + +- Finance and markets, company KPIs, and earnings +- Macroeconomics — inflation, unemployment, GDP, policy rates +- Website and app traffic, demographics, energy, real estate, health +- Sports, weather, elections, and prediction markets + +Both surfaces are configurable per call, so you can search the web, the structured data, or +both. Learn more in the [Tako documentation](https://docs.tako.com). + +## Setup + +The Tako adapter is available in the `@takoviz/ai-sdk` package. You can install it with: + + + +Set your Tako API key: + +```bash +export TAKO_API_KEY=your_api_key +``` + +You can get an API key from the [Tako developer console](https://tako.com/console/api-keys). + +## Tools + +The package exports three tools. Each is a factory that takes optional configuration and +returns an AI SDK tool. + +| Tool | What it does | +| ---------------- | ------------------------------------------------------------------ | +| `takoSearch()` | Retrieval: Tako knowledge cards plus web results, no synthesis | +| `takoAnswer()` | Retrieval plus an LLM-synthesized, cited answer | +| `takoContents()` | Downloads the data behind a result — a card's rows or a page's text | + +The model supplies only the dynamic input: `{ query }` for `takoSearch` and `takoAnswer`, and +`{ url }` for `takoContents`. Everything else is configured in your code, not chosen by the +model. + +## Tool Usage + +### `generateText` + +Use `takoAnswer` when you want one cited figure synthesized into the response: + +```ts +import { generateText, isStepCount } from 'ai'; +import { openai } from '@ai-sdk/openai'; +import { takoAnswer } from '@takoviz/ai-sdk'; + +const { text } = await generateText({ + model: openai('gpt-4o-mini'), + prompt: 'Did AMD or Nvidia grow headcount faster over the last decade?', + tools: { + tako_answer: takoAnswer(), + }, + stopWhen: isStepCount(5), +}); + +console.log(text); +``` + +### `streamText` + +Give the agent the full toolset so it can search for breadth, answer for a specific figure, +and drill into the underlying rows: + +```ts +import { streamText, isStepCount } from 'ai'; +import { openai } from '@ai-sdk/openai'; +import { takoSearch, takoAnswer, takoContents } from '@takoviz/ai-sdk'; + +const result = streamText({ + model: openai('gpt-4o'), + prompt: 'Compare monthly visits for openai.com and anthropic.com over the past year.', + tools: { + tako_search: takoSearch(), + tako_answer: takoAnswer(), + tako_contents: takoContents({ mode: 'inline' }), + }, + stopWhen: isStepCount(8), +}); + +for await (const part of result.fullStream) { + if (part.type === 'text-delta') { + process.stdout.write(part.text); + } +} +``` + +### With AI Gateway models + +Tako's tools are executed by the AI SDK in your own process, so they compose with any model — +including a bare model string routed through [AI Gateway](/providers/ai-sdk-providers/ai-gateway). +No extra configuration is needed: + +```ts +import { generateText, isStepCount } from 'ai'; +import { takoSearch, takoAnswer } from '@takoviz/ai-sdk'; + +const { text } = await generateText({ + model: 'openai/gpt-5.6-sol', // routed through AI Gateway + prompt: 'How has Nvidia revenue tracked against AMD since 2020?', + tools: { + tako_search: takoSearch(), + tako_answer: takoAnswer(), + }, + stopWhen: isStepCount(5), +}); +``` + +You need a Tako API key for the tools and a Gateway credential for the model; the two are +independent. + +## Configuration + +### `takoSearch` and `takoAnswer` + +Both take the same configuration object: + +```ts +import { takoSearch } from '@takoviz/ai-sdk'; + +const tool = takoSearch({ + apiKey: process.env.TAKO_API_KEY, + baseUrl: 'https://tako.com', + effort: 'fast', + sources: { + data: { count: 5, includeContents: false }, + web: { count: 5, includeContents: false }, + }, + countryCode: 'US', + locale: 'en-US', + timezone: 'America/New_York', + outputSettings: { + imageDarkMode: false, + forceRefresh: false, + }, +}); +``` + +- **apiKey** _string_ + + API key sent with the request. Defaults to the `TAKO_API_KEY` environment variable. + +- **baseUrl** _string_ + + Base URL of the Tako API. Defaults to `https://tako.com`. + +- **effort** _'instant' | 'fast' | 'deep'_ + + Retrieval depth. Defaults to `'fast'`. `'instant'` trades recall for latency; `'deep'` + searches more broadly. + +- **sources** _object_ + + Which surfaces to search. A source is searched only if its key is present; omit `sources` + entirely to search both. `data` is Tako's proprietary data, `web` is the live web. Each + takes `count` (how many results) and `includeContents` (inline the underlying data with + the result). + +- **countryCode** _string_ + + ISO 3166-1 alpha-2 country code for regional results. Defaults to `'US'`. + +- **locale** _string_ + + Locale for result formatting. Defaults to `'en-US'`. + +- **timezone** _string_ + + IANA timezone name, such as `'America/New_York'`, used to resolve relative dates in queries. + +- **outputSettings** _object_ + + `imageDarkMode` renders card images for dark backgrounds. `forceRefresh` bypasses cached + data and applies to `'instant'` effort only. + +### `takoContents` + +```ts +import { takoContents } from '@takoviz/ai-sdk'; + +const tool = takoContents({ + apiKey: process.env.TAKO_API_KEY, + baseUrl: 'https://tako.com', + mode: 'url', +}); +``` + +- **mode** _'url' | 'inline'_ + + How content is delivered. Defaults to `'url'`, which returns a short-lived presigned + download link — use this when you want to hand a download to a user. `'inline'` returns the + content in the response body so the model can read and compute over the numbers directly. + + The tool description the model reads changes with this setting, so the model knows whether + to expect a link or data. + +## Results + +`takoSearch` resolves to: + +```ts +{ + cards: TakoCard[]; // knowledge cards: title, description, image_url, embed_url, sources + web_results: TakoWebResult[]; + request_id: string; + usage?: TakoUsage | null; +} +``` + +`takoAnswer` returns the same shape plus `answer: string`, with the lead card at `cards[0]`. +`takoContents` resolves to `{ contents: TakoContentItem[]; request_id: string; usage? }`. + +The API's contract permits omitting empty collections, so the tools normalize the results: +`cards`, `web_results`, and `contents` are always arrays. + +Two card fields are worth knowing about: + +- **`exportable`** — whether `takoContents` can download that card's rows. When `false`, the + call returns 403 and retrying will not help; use the card's chart or ask `takoAnswer` for + the figures instead. +- **`data_freshness`** — `{ data_as_of, last_updated }`, so the model can state how current a + number is. + +On each contents item, `content_format` names the serialization: absent or `null` for web page +text (in `data`), `'csv'` for card data (in `data`), `'json_records'` (in `records`), or +`'json_compact'` (in `dataset`). `total_rows` and `truncated` tell you whether a card had more +rows than were returned. + +## TypeScript + +Full type definitions ship with the package: + +```ts +import type { + TakoRetrievalConfig, + TakoContentsConfig, + TakoSearchResult, + TakoAnswerResult, + TakoContentsResult, + TakoCard, + TakoWebResult, + TakoContentItem, + TakoDataset, +} from '@takoviz/ai-sdk'; +``` + +The types mirror Tako's published OpenAPI document and are contract-tested against it. From 099a9e4d7d05dc8b08552c76bb786669eaf5e31d Mon Sep 17 00:00:00 2001 From: Eric Date: Mon, 3 Aug 2026 16:46:55 -0700 Subject: [PATCH 2/2] docs: align Tako copy with official positioning, refresh model ids Rewrites the intro to Tako's own positioning (the knowledge layer for agents) instead of framing it as a search engine, and restates the proprietary-data domain list to match docs.tako.com. Also updates the two generateText/streamText examples from gpt-4o-mini and gpt-4o to gpt-5.6-sol, matching the Gateway example on the same page and the model ids used in content/docs/02-foundations. --- .../05-community-providers/53-tako.mdx | 36 +++++++++---------- 1 file changed, 17 insertions(+), 19 deletions(-) diff --git a/content/providers/05-community-providers/53-tako.mdx b/content/providers/05-community-providers/53-tako.mdx index a950c1c47efa..0fcd93e4cf6e 100644 --- a/content/providers/05-community-providers/53-tako.mdx +++ b/content/providers/05-community-providers/53-tako.mdx @@ -5,23 +5,21 @@ description: Learn how to use Tako with the AI SDK. # Tako -[Tako](https://tako.com) is a live-data search engine. A single call searches both the live web -and Tako's own structured data, returning web results alongside knowledge cards — charts and -metrics that carry their sources and freshness metadata. The +[Tako](https://tako.com) is the knowledge layer for agents, grounding your AI with the most +accurate proprietary data and web content. The [`@takoviz/ai-sdk`](https://www.npmjs.com/package/@takoviz/ai-sdk) package integrates Tako with the AI SDK as a set of tools. -It covers what a web search tool covers, and adds a structured layer on top. For a question -that turns on a number, you get the value, the source it came from, how current it is, and a -chart you can render — instead of prose to parse. That layer is deepest in: +Tako grounds your agent in two kinds of knowledge at once: proprietary structured data from +trusted providers, and full web search. One API returns typed values with named sources when +curated data exists, and agent-ready web results and page text for everything else. -- Finance and markets, company KPIs, and earnings -- Macroeconomics — inflation, unemployment, GDP, policy rates -- Website and app traffic, demographics, energy, real estate, health -- Sports, weather, elections, and prediction markets +Domains Tako covers with proprietary data: finance and markets, company KPIs and earnings, +macroeconomics (inflation, unemployment, GDP, policy rates), website and app traffic, sports, +weather, elections, prediction markets, demographics, energy, and real estate. -Both surfaces are configurable per call, so you can search the web, the structured data, or -both. Learn more in the [Tako documentation](https://docs.tako.com). +Both surfaces are configurable per call, so you can search the curated data, the web, or both. +Learn more in the [Tako documentation](https://docs.tako.com). ## Setup @@ -42,11 +40,11 @@ You can get an API key from the [Tako developer console](https://tako.com/consol The package exports three tools. Each is a factory that takes optional configuration and returns an AI SDK tool. -| Tool | What it does | -| ---------------- | ------------------------------------------------------------------ | -| `takoSearch()` | Retrieval: Tako knowledge cards plus web results, no synthesis | -| `takoAnswer()` | Retrieval plus an LLM-synthesized, cited answer | -| `takoContents()` | Downloads the data behind a result — a card's rows or a page's text | +| Tool | What it does | +| ---------------- | ------------------------------------------------------------------------ | +| `takoSearch()` | Knowledge cards plus web results for a query, no synthesis | +| `takoAnswer()` | The same retrieval, blended into a synthesized, source-attributed answer | +| `takoContents()` | The data behind a result: a card's rows, or a page's full text | The model supplies only the dynamic input: `{ query }` for `takoSearch` and `takoAnswer`, and `{ url }` for `takoContents`. Everything else is configured in your code, not chosen by the @@ -64,7 +62,7 @@ import { openai } from '@ai-sdk/openai'; import { takoAnswer } from '@takoviz/ai-sdk'; const { text } = await generateText({ - model: openai('gpt-4o-mini'), + model: openai('gpt-5.6-sol'), prompt: 'Did AMD or Nvidia grow headcount faster over the last decade?', tools: { tako_answer: takoAnswer(), @@ -86,7 +84,7 @@ import { openai } from '@ai-sdk/openai'; import { takoSearch, takoAnswer, takoContents } from '@takoviz/ai-sdk'; const result = streamText({ - model: openai('gpt-4o'), + model: openai('gpt-5.6-sol'), prompt: 'Compare monthly visits for openai.com and anthropic.com over the past year.', tools: { tako_search: takoSearch(),