Attach or detach knowledge bases on a Ringg AI agent, mention them in the prompt with @, add query phrases, and test that the agent answers from your data.
An agent can have several knowledge bases, and one knowledge base can serve many agents.In the dashboard: Agents (listed under Assistants in the sidebar) → open an agent → Knowledge Base in the editor sidebar.
Attaching knowledge bases and mentioning one in the prompt
1
Pick knowledge bases
In the agent editor, click Knowledge Base, then Select Knowledge Base, and tick one or more. Each tick attaches it at once: “Knowledge base attached successfully”. The button then shows the count.
Two knowledge bases attached
2
Detach
Click the trash icon on an attached knowledge base, or untick it in the list: “Knowledge base detached successfully”.
Attached knowledge bases are listed below the button and appear under Knowledge Bases when you type @ in the prompt.
Add Knowledge Base at the bottom of the list opens the Knowledge base page to create a new one (Create a knowledge base). If the button reads No knowledge bases found, the workspace has none yet; create one there first.You can also attach knowledge bases while you create the agent.Attachments belong to the version you are editing. On an agent with several versions, attach the knowledge base to each version that needs it.
An Agent node’s Knowledge base section (node types)
That node only
Changes go into the draft, so publish the agent for callers to get them. Once a node has a knowledge base or an on-call tool, it also shows Query Phrases: “Phrases the assistant will say before querying a knowledge base or running an on-call tool on this node.” Add short fillers such as “Let me check that for you.” so the caller does not hear silence during the lookup.
Type @ in the prompt and pick the knowledge base from the Knowledge Bases group. Only attached knowledge bases are listed. A mention isn’t required: the agent can search every attached knowledge base either way. The mention uses the knowledge base’s name and tells the agent which knowledge base covers which questions. For a knowledge base named loan_faqs:
For questions about interest rates, eligibility or documents, answer from @loan_faqs.If the answer is not there, say you will check and have an advisor call back.
Attached knowledge bases in the @ menu
See Write the prompt for how mentions work. If you detach a knowledge base that the prompt still mentions, the mention turns red; remove it or attach the knowledge base again.
During the conversation, the agent searches an attached knowledge base when it decides a question needs it, not on every turn, and answers from what it finds. For CSV columns marked Exact match (column configuration), the lookup matches the exact value, such as an order ID the caller reads out.
Call Edit Assistant (PATCH /agent/v1) with operation set to attach_kb or remove_kb and the kb_id, once per knowledge base. Send your API key in X-API-KEY.
