Knowledge base
Attach a semantic knowledge base to an agent so it can answer from your own facts — add sources from text, Q&A pairs, or URLs.
Knowledge base
A knowledge base (KB) gives an agent your own facts to draw on during a call — pricing, policies, FAQs, product details. Sources are embedded and searched semantically, so the agent retrieves the relevant passage even when the caller phrases a question differently.
Add sources
Build up a KB from three kinds of source. Each is added with its own MCP tool (and the equivalent REST endpoint / CLI command).
| Source | MCP tool | Use it for |
|---|---|---|
| Free text | add_kb_text | Pasted documents, policy text, notes. |
| Q&A pair | add_kb_qa | Crisp answers to common questions. |
| URL | add_kb_url | A page Agoralia fetches and ingests. |
add_kb_qa(question="What is your refund window?", answer="30 days from purchase, no questions asked.")
add_kb_text(text="Acme Pro is €49/mo billed annually. The Team plan is €99/mo...")
add_kb_url(url="https://acme.com/pricing")List what's ingested with list_kb_sources, remove a source with delete_kb_source, and
test retrieval directly with search_kb.
search_kb(query="how much does the team plan cost")Attach to an agent
An agent carries a knowledge_base field — the sources it can search at call time. Set it
when you create the agent or update it later, then re-publish so the change reaches the
voice provider.
Re-publish after KB changes
Attaching or detaching KB sources changes the agent's configuration. Run
publish_agent (POST /agents/{id}/publish) again so the live agent picks it up.
See Agents.
Next
- Agents — configure and publish the agent that uses this KB.
- Single call · Campaigns
Phone numbers
Call from an Agoralia pool number auto-assigned per destination country, or bring your own number from Telnyx, Twilio, Vonage, Sinch, Bird, Infobip, Bandwidth, or SIP.
Single call
Place one outbound call with POST /api/v1/calls — body fields, the recording_enabled toggle, and the recording advisory in the response.