Knowledge-base sequence
- Create a knowledge base.
- Add text or URL sources.
- Wait for processing to complete.
- Inspect source status and errors.
- Attach the knowledge base to the intended voice agent (
knowledge_base_idson Update agent). - Test retrieval before publishing the agent.
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.