Documentation

Web Search

Web search lets your agent fetch fresh information from the internet mid-conversation, so it can answer questions that go beyond its training data or your knowledge base. Turn it on with a single flag when creating or updating an agent.

When to use it

  • Answering questions about current events, prices, or availability that change over time.
  • Looking up public details the agent was not explicitly given.
  • Supplementing a knowledge base when a caller asks something outside your documents.

Enable it

Set web_search.enabled totrue. The agent decides when a search is helpful during the call.

cURL
curl -X PUT "https://bkbharatai.blutec.ai/api/agents/AGENT_ID" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "web_search": {
      "enabled": true,
      "provider": "DuckDuckGo"
    }
  }'

Best practices

  • Prefer a knowledge base for facts you control — it is faster and always on-brand.
  • Keep it enabled for open-ended assistants; disable it for tightly scripted flows where off-topic answers are undesirable.
  • A web lookup adds a moment of latency, so use it where accuracy matters more than speed.

Full options: Agent API.