Skip to main content
Search backend in training and evaluation environments Two research frameworks can send their environment’s web searches to Keenable: SkillOpt from Microsoft, for OfficeQA rollouts, and Halo from White Circle, for async-GRPO search environments. In both, Keenable is opt-in. You select it with one config value, and the default backend doesn’t change. Both run from a checkout of the repository’s main branch.

SkillOpt OfficeQA

SkillOpt trains an agent’s skill document against benchmarks. In OfficeQA, env.search_mode decides how a rollout gathers evidence. The default, offline, searches only the local document corpus. Set it to keenable on the command line:
Each round sends each query from the model’s <search_queries> to Keenable, one POST per query. A request carries the query text, max_results, an X-Keenable-Title: SkillOpt header and, only if you set KEENABLE_API_KEY, your key in X-API-Key. SkillOpt doesn’t send the task question or the OfficeQA corpus. A generated query is model output, though, so it can repeat text from them. Keenable doesn’t need the local OfficeQA corpus. Rate-limit and other service errors fail the rollout with a search diagnostic: SkillOpt never falls back to another provider. SkillOpt’s docs note that scores with Keenable aren’t directly comparable to the paper’s Google-backed search setting.

Halo search environments

In Halo, the qa_search environment (and exam_qa with open_book) gives the policy a web search tool. Set the backend in the environment’s config:
Export your key in the training environment:
Halo calls POST https://api.keenable.ai/v1/search with your key in X-API-Key. Each result’s snippet is collapsed to one line and cut to 500 characters, because Keenable’s snippet is page text where other backends return a sentence or two.
Halo’s Keenable backend calls only the keyed endpoint. Without KEENABLE_API_KEY, every search returns 401 with the error code missing_api_key. Create a key in the console. See API keys.
SkillOpt without a key runs on the shared public tier at lower rate limits, which a long training run can reach. Set KEENABLE_API_KEY for sustained runs.

AgentField

Run AgentField’s deep research example on Keenable web search with SEARCH_PROVIDER=keenable. No account or API key needed.

ToolUniverse

Select Keenable as the backend of ToolUniverse’s web_search tool with backend=“keenable”, in ToolUniverse 1.5.9 and later. No API key required.

npcpy

Search the web from npcpy with the keenable provider for search_web, or call search_keenable directly. No API key needed, in npcpy 2.1.28 and later.

Overview

Install the official Keenable SDK for Python, TypeScript, Go or Rust with one command, search with no key, then add fetch, tool calling and Monitors.