Skip to main content

Knowledge-base sequence

  1. Create a knowledge base.
  2. Add text or URL sources.
  3. Wait for processing to complete.
  4. Inspect source status and errors.
  5. Attach the knowledge base to the intended voice agent (knowledge_base_ids on Update agent).
  6. Test retrieval before publishing the agent.
Source ingestion can be asynchronous. A successful response to add_sources means the source was accepted, not necessarily that retrieval is ready. Preserve the source ID and check its status by reading the knowledge base again.

Source changes

Treat source edits and removals as explicit administrative operations. Do not remove the previous source (remove_source_ids) until the replacement has been processed and reviewed. Restoring a synced source and accepting a provider update are done in the Sendora app.

Tools

Use the tool catalog (GET /tools?catalog=true, or add agent_id for one agent’s catalog) to understand available capabilities. Test a tool with safe generated inputs before attaching it to a published agent. Custom HTTP tools can create external side effects; restrict their destination, inputs, and permissions.