For Your Coding Agent

# 1. Dispatch — returns 202 with {"run_id": "...", "status": "queued"}.
curl -X POST https://tako.com/api/v1/agent/search/runs \
  -H "X-API-Key: $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Largest US semiconductor companies by 2024 revenue and YoY growth"
  }'

# 2. Poll with the run_id until status is "completed" or "failed".
curl https://tako.com/api/v1/agent/search/runs/RUN_ID \
  -H "X-API-Key: $TAKO_API_KEY"

import os
import time
from tako import Configuration
from tako.lib import Tako
from tako.models.search_agent_run_request import SearchAgentRunRequest

config = Configuration()
config.api_key["apiKey"] = os.environ["TAKO_API_KEY"]
client = Tako(config)

run = client.agent.search.run(
    SearchAgentRunRequest(query="Largest US semiconductor companies by 2024 revenue and YoY growth")
)

# Runs can take minutes — poll on a short interval until terminal.
while run.status not in ("completed", "failed"):
    time.sleep(3)
    run = client.agent.search.get(run.run_id)

if run.status == "completed":
    print(run.result.answer)
    for card in run.result.cards or []:
        print(card.title, card.webpage_url)

import { Tako } from "tako-sdk";

const tako = new Tako({ apiKey: process.env.TAKO_API_KEY! });

let run = await tako.agent.search.run({
  query: "Largest US semiconductor companies by 2024 revenue and YoY growth",
});

// Runs can take minutes — poll on a short interval until terminal.
while (run.status !== "completed" && run.status !== "failed") {
  await new Promise((r) => setTimeout(r, 3000));
  run = await tako.agent.search.get(run.run_id);
}

if (run.status === "completed") {
  console.log(run.result?.answer);
  for (const card of run.result?.cards ?? []) {
    console.log(card.title, card.webpage_url);
  }
}

import os
from tako import Configuration
from tako.lib import Tako
from tako.models.search_agent_run_request import SearchAgentRunRequest

config = Configuration()
config.api_key["apiKey"] = os.environ["TAKO_API_KEY"]
client = Tako(config)

req = SearchAgentRunRequest(query="Largest US semiconductor companies by 2024 revenue and YoY growth")

with client.agent.search.stream(req) as stream:
    for event in stream:
        block = event.block.actual_instance
        print(f"seq={event.seq} kind={block.kind}")
        if block.kind == "agent_result":
            print(block.data.answer)
    # The stream ends at stream_done. If it ended without a terminal result
    # (but produced at least one event, so run_id is known), poll for status:
    if stream.result is None and stream.run_id is not None:
        run = client.agent.search.get(stream.run_id)
        print(run.status)

curl -X POST https://tako.com/api/v1/agent/search/runs \
  -H "X-API-Key: $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"query": "Largest US semiconductor companies by 2024 revenue and YoY growth"}'

import jsonschema
from tako.lib import Tako, TakoDatasetView, derive_response_schema
from tako.models.search_agent_run_request import SearchAgentRunRequest

schema = {
    "type": "object",
    "properties": {
        "summary": {"type": "string", "description": "One-sentence summary."},
        "companies": {"x-tako-dataset": True, "columns": ["company", "revenue_usd", "yoy_growth_pct"]},
    },
    "required": ["summary"],
}

run = client.agent.search.run(
    SearchAgentRunRequest(query="Largest US semiconductor companies by 2024 revenue", output_schema=schema)
)
run = client.agent.search.get(run.run_id)  # poll to a terminal status

if run.result and run.result.structured_output:
    jsonschema.validate(run.result.structured_output, derive_response_schema(schema))
    view = TakoDatasetView(run.result.structured_output["companies"])
    print(view.records)          # list[dict], one per row
    print(view.to_dataframe())   # typed pandas DataFrame (needs tako-sdk[pandas])

import { Tako, TakoDatasetView, deriveResponseSchema } from "tako-sdk";

const tako = new Tako({ apiKey: process.env.TAKO_API_KEY! });

const schema = {
  type: "object",
  properties: {
    summary: { type: "string" },
    companies: { "x-tako-dataset": true, columns: ["company", "revenue_usd", "yoy_growth_pct"] },
  },
  required: ["summary"],
};

const dispatched = await tako.agent.search.run({ query: "...", output_schema: schema });
const run = await tako.agent.search.get(dispatched.run_id); // poll to a terminal status

const output = run.result?.structured_output;
if (output) {
  const view = new TakoDatasetView(output.companies);
  console.log(view.records);
}