Skip to content

Integrations

Agent skill

The telem-search agent skill teaches your coding agent to call the Telem API directly. It is one page that your agent reads when a task needs the live web. Nothing is installed into your agent.

Want native tools instead? The installer adds Telem to the coding agents you have, with telem_search and telem_fetch as tools, and a record of each session in the console. This page is the lightweight path.

Create a Telem API key

  1. Open your project
  2. API keys
  3. Issue API key

tlm_••••••••••••••••Keys start with tlm_.

Open the console

Never paste a key into a chat with your agent. Every path below sets it for you.

Teach your agent the Telem API

  1. Add the skill. The command installs telem-search for your agent.

    Terminal window
    npx skills add https://docs.telem.ai
  2. Set your key in the shell that starts your agent. The skill tells the agent to read it from the environment at call time.

    Terminal window
    export TELEM_API_KEY=tlm_your_key
  3. Ask your agent to search. For example: “Search the web with Telem for the latest PostgreSQL release.” The agent reads the skill and calls POST /v1/search.

The skill is a single SKILL.md. It teaches your agent these things:

  • When to search, and when not to. An answer already in the model’s weights is a reason not to spend a search. So are a private corpus and a URL that the agent already has.
  • The request. POST https://router.telem.ai/v1/search, with the query in user_input and everything else in the optional search block. The skill shows it in curl, TypeScript and Python.
  • How to read the response. The response has one entry per provider under preprocessor_runs. Each entry has its own normalized response, status and error. So when one provider fails, you get a partial result, and the request does not fail. The skill also shows the flatten-and-merge pass that turns those entries into one list.
  • How to write a query. The providers use two retrieval styles, so a full natural-language sentence works better than a keyword fragment.
  • The cost options. tier, num_results, and why an explicit search.providers.include makes the price of a call your decision.
  • warnings[] and the error table. Which statuses to retry, and which ones give the same failure again.
  • Reading one known URL with POST /v1/fetch, instead of a search for a page that the agent can already name.

The skill tells the agent to read the key from the environment at call time. It also tells the agent never to do these things with the key:

  • hardcode it
  • commit it
  • print it into a snippet
  • send it to a browser

You can read the same page yourself: SKILL.md.

npx skills add https://docs.telem.ai fetches https://docs.telem.ai/.well-known/agent-skills/index.json and finds the telem-search entry. Then it downloads the SKILL.md beside it, at /.well-known/agent-skills/telem-search/SKILL.md. Some hosts have their own remote-skill registries, OpenCode for example. They read the same two files.

If your host installs skills another way, point it at either URL directly. The skill is a plain Markdown file with YAML frontmatter. It has no dependencies, no scripts and no install step.

Agent skill Installer
Search available to the agent yes, as HTTP the model writes yes, as a native telem_search tool
Page fetch the skill teaches POST /v1/fetch telem_fetch, a native tool
Results rendered with provider attribution your code does it the plugin does it
Retrieval metrics and trajectory analytics no yes
Touches your framework config no yes

A plugin gives the model better tools. It also gives you a record of what the model searched for.

To update the skill:

Terminal window
npx skills update telem-search

To remove it:

Terminal window
npx skills remove telem-search

A skill costs nothing to remove, and it does not change how your agent runs.

API reference

Every endpoint the skill describes.

Search parameters

What each search option does, from tiers to date windows.

Parameters

Every request option and its limit.

Errors

Every error the API returns, and what to do.

Was this page helpful?