Quickstart

Agent runs a multi-step research loop over the web and returns a cited answer: it plans its own searches, follows up on what it finds, and keeps going until it has enough to answer, rather than the one grounding search Answer makes. This quickstart walks through a simple workflow that starts an agent run then gets its results.

1. Send a query

A run is asynchronous. create returns at once with the run in pending state; the SDKs’ create_and_wait / createAndWait starts a run and blocks until it finishes, which is the easiest way to get a result end to end. The only required field is query. See Basic run for the cURL form, which only starts the run and needs a separate poll to read the result.

from seltz import Seltz

client = Seltz(api_key="your-api-key")

run = client.agent.create_and_wait(
    "What are the three most notable AI-company acquisitions announced in 2026?"
)

import { Seltz } from "seltz";

const client = new Seltz({ apiKey: "your-api-key" });

const run = await client.agent.createAndWait({
  query: "What are the three most notable AI-company acquisitions announced in 2026?",
});

Runs typically finish in well under a minute for a simple question, but a harder one can take several minutes and up to around an hour. create_and_wait / createAndWait block until then; pass timeout / timeoutMs to bound the client-side wait.

2. Read the result

create_and_wait / createAndWait only return once the run is done, so this part is safe: a completed run’s output.text is a cited Markdown report, with inline [n] markers pointing at output.sources. Checking a run that is not done yet, over cURL or your own poll loop, gets you back status: "running" (or "pending") instead, with output’s fields still unset. See Basic run for what that looks like.

print(run.output.text)
for source in run.output.sources:
    print(f"[{source.id}] {source.url}")

console.log(run.output?.text);
for (const source of run.output?.sources ?? []) {
  console.log(`[${source.id}] ${source.url}`);
}

Example output

Three notable AI-company acquisitions announced in 2026 include:

- **SpaceX → Anysphere (Cursor):** an all-stock deal valuing the AI coding-assistant company at approximately $60 billion. [1]
- **Zendesk → Forethought:** the AI-agent company automating customer-service interactions. [2]
- **Palo Alto Networks → Console:** an AI-agent company automating IT help-desk tasks. [3]

[1] https://www.latestly.com/technology/spacex-to-acquire-ai-coding-startup-cursor-in-usd-60-billion-deal-7475967.html
[2] https://techcrunch.com/2026/03/11/zendesk-acquires-agentic-customer-service-startup-forethought/
[3] https://techcrunch.com/2026/09/02/palo-alto-networks-paid-500m-for-thrive-backed-console-sources-say/

Next steps

To learn more about Seltz Agent, check out the following topics:

Concepts: the run lifecycle, output shapes, and citations
Basic run: the full request/response cycle, including the cURL poll
Structured output: requesting a JSON result instead of Markdown
List runs: paging this org’s runs, newest first
Poll for completion: managing the wait yourself
Cancel a run: best-effort cancellation, and why it can lose the race to completion
Handle errors: rejected requests versus failed runs
Reference: endpoints, fields, limits and errors
Agent API Reference: full REST request and response specification

Getting Started

Web Tools

Data

Tutorials

Integrations

SDKs

1. Send a query

2. Read the result

Next steps

​1. Send a query

​2. Read the result

​Next steps

1. Send a query

2. Read the result

Next steps