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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ringg AI","description":"Build AI agents that make and answer phone calls, talk on your website and chat on WhatsApp, then run them from the Ringg AI dashboard or REST API.","colors":{"primary":"#0A0A0B","light":"#FFFFFF","dark":"#0A0A0B"},"logo":{"light":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/light.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=053f22dbaf5140cd8e5dadb1d4d057cd","dark":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=cf9075384ec572e1a19b939d5a8674af","href":"https://www.ringg.ai"},"favicon":"https://mintcdn.com/ringgai-0da73d20/ZLVFI55VhZ4gmYrF/favicon.svg?fit=max\u0026auto=format\u0026n=ZLVFI55VhZ4gmYrF\u0026q=85\u0026s=e612fcf76df43d6468baa340dc3fde50","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]},"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://prod-api.ringg.ai/ca/api/v0"}},"appearance":{"default":"dark"},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"/resources/learn/all-lessons","label":"Learn"},{"href":"mailto:admin@ringg.ai","label":"Contact us"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.ringg.ai/dashboard"}},"footer":{"socials":{"x":"https://x.com/ringg_ai","linkedin":"https://www.linkedin.com/company/ringg","youtube":"https://www.youtube.com/@RinggAI","instagram":"https://www.instagram.com/ringg_ai","discord":"https://discord.gg/YuEnb8Vsca"},"links":[{"header":"For AI agents","items":[{"label":"llms.txt","href":"https://docs.ringg.ai/llms.txt"},{"label":"skill.md","href":"https://docs.ringg.ai/skill.md"},{"label":"OpenAPI spec","href":"https://docs.ringg.ai/api-reference/openapi.json"},{"label":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"search":{"prompt":"Search the docs"},"seo":{"metatags":{"canonical":"https://docs.ringg.ai","og:site_name":"Ringg AI Docs","twitter:site":"@ringg_ai"},"organization":{"id":"https://www.ringg.ai/#organization","legalName":"Stoic AI Private Limited","url":"https://www.ringg.ai","logo":"https://assets.ringg.ai/images/logo/logo.svg","sameAs":["https://x.com/ringg_ai","https://www.linkedin.com/company/ringg","https://www.youtube.com/@RinggAI","https://www.instagram.com/ringg_ai","https://discord.gg/YuEnb8Vsca"]}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"errors":{"404":{"redirect":false,"title":"This page doesn't exist","description":"It may have moved in the docs rebuild. The suggestions below usually have it; otherwise start from [the introduction](/get-started/ringg-ai) or search above."}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","download-spec"],"display":"header"},"markdown":{"instructions":["To search or read these docs, connect the Ringg docs MCP server at https://docs.ringg.ai/mcp (no key needed; tools search_ringg_ai and query_docs_filesystem_ringg_ai) instead of browsing pages one by one. Setup for each client: https://docs.ringg.ai/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants.md","The dashboard labels agents \"Assistants\"; these docs say \"agent\". Both mean the same object, identified by agent_id.","API base URL: https://prod-api.ringg.ai/ca/api/v0. Send the workspace API key in the X-API-KEY header, from server-side code only.","Placing a call dials a real phone number and spends credits. Confirm the number with the user before calling.","To act on a Ringg workspace (place calls, edit agents, read transcripts), use the separate Ringg workspace MCP server at https://mcp.ringg.ai/mcp: https://docs.ringg.ai/resources/mcp-server/workspace-mcp-server/overview.md"]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ringgai-0da73d20","hasAudioNarration":false,"actualSubdomain":"ringgai-0da73d20","customDomains":["docs.ringg.ai"],"gitSource":{"type":"github","owner":"stonkr","repo":"ringg-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6adb52e21a579503f2299e23","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Documentation","count":90},{"language":"default","tag":"API reference","count":52},{"language":"default","tag":"Build agents","count":37},{"language":"default","tag":"Resources","count":34},{"language":"default","tag":"Learn","count":27},{"language":"default","tag":"Inventory","count":23},{"language":"default","tag":"Deploy","count":22},{"language":"default","tag":"Customize agent behaviour","count":19},{"language":"default","tag":"Agents","count":17},{"language":"default","tag":"Calling","count":15}],"searchSettings":{"showContentSnippets":true,"maxResults":8}},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.nav-logo{height:1.375rem!important;width:auto!important}.figure-card{display:flex;flex-direction:column;margin:0.5rem 0;overflow:hidden;border:1px solid rgb(10 10 11 / 0.08);border-radius:1rem;background:#ffffff;text-decoration:none!important;transition:border-color 150ms}.figure-card:hover{border-color:rgb(10 10 11 / 0.2)}.dark .figure-card{border-color:rgb(255 255 255 / 0.08);background:rgb(var(--background-dark))}.dark .figure-card:hover{border-color:rgb(255 255 255 / 0.2)}.figure-card-panel{display:flex;justify-content:center;height:12rem;margin:0.375rem 0.375rem 0;border-radius:0.75rem;-webkit-mask-image:linear-gradient(to bottom, #000 62%, transparent);mask-image:linear-gradient(to bottom, #000 62%, transparent);background:#f6f6f7 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%230a0a0b' stroke-opacity='0.03' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.dark .figure-card-panel{background:#0f0f11 url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='384' height='256' fill='none' stroke='%23ffffff' stroke-opacity='0.025' stroke-width='1.5'%3E%3Ccircle cx='32' cy='32' r='25'/%3E%3Ccircle cx='96' cy='32' r='25'/%3E%3Crect x='135' y='7' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='32' r='25'/%3E%3Ccircle cx='288' cy='32' r='25'/%3E%3Ccircle cx='352' cy='32' r='25'/%3E%3Ccircle cx='32' cy='96' r='25'/%3E%3Ccircle cx='96' cy='96' r='25'/%3E%3Ccircle cx='160' cy='96' r='25'/%3E%3Ccircle cx='224' cy='96' r='25'/%3E%3Ccircle cx='288' cy='96' r='25'/%3E%3Ccircle cx='352' cy='96' r='25'/%3E%3Ccircle cx='32' cy='160' r='25'/%3E%3Crect x='71' y='135' width='50' height='50' rx='8'/%3E%3Ccircle cx='160' cy='160' r='25'/%3E%3Ccircle cx='224' cy='160' r='25'/%3E%3Crect x='263' y='135' width='50' height='50' rx='8'/%3E%3Crect x='327' y='135' width='50' height='50' rx='8'/%3E%3Crect x='7' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='96' cy='224' r='25'/%3E%3Crect x='135' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='224' cy='224' r='25'/%3E%3Crect x='263' y='199' width='50' height='50' rx='8'/%3E%3Ccircle cx='352' cy='224' r='25'/%3E%3C/svg%3E\") center / 192px 128px}.figure-card-panel{--hairline-plate: #f6f6f7}.dark .figure-card-panel{--hairline-plate: #0f0f11}.figure-card-panel>[data-hairline]{width:13.75rem}.figure-card-text{flex:1;padding:0.25rem 1.25rem 1.25rem}.figure-card-title{font-weight:600;color:rgb(17 24 39)}.dark .figure-card-title{color:rgb(255 255 255)}.figure-card-body{margin-top:0.25rem;font-size:0.9375rem;line-height:1.6;color:rgb(75 85 99)}.dark .figure-card-body{color:rgb(161 161 170)}"}],"page":{"pagePath":"documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base","slug":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base","pageMetadata":{"title":"Attach a knowledge base","sidebarTitle":"Attach a knowledge base","description":"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.","og:title":"Attach a knowledge base to a Ringg AI agent","href":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,Check,CodeBlock,Columns,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`An agent can have several knowledge bases, and one knowledge base can serve many agents.`}),`\n`,_jsxs(_components.p,{children:[`In the dashboard: Agents (listed under `,_jsx(_components.strong,{children:`Assistants`}),` in the sidebar) → open an agent → `,_jsx(_components.strong,{children:`Knowledge Base`}),` in the editor sidebar.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`A knowledge base`,icon:`book-open`,href:`/documentation/inventory/knowledge-base#create-a-knowledge-base`,horizontal:true,children:_jsxs(_components.p,{children:[`Created in the same workspace, with status `,_jsx(_components.strong,{children:`Ready`}),`.`]})}),_jsx(Card,{title:`An agent`,icon:`bot`,href:`/documentation/build-agents/agents/create-an-agent`,horizontal:true,children:_jsx(_components.p,{children:`The agent that will answer from it.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`attach-or-detach-a-knowledge-base`,children:`Attach or detach a knowledge base`}),`\n`,_jsx(Frame,{caption:`Attaching knowledge bases and mentioning one in the prompt`,children:_jsx(`video`,{alt:`Attaching knowledge bases and mentioning one in the prompt`,\"aria-label\":`Attaching knowledge bases and mentioning one in the prompt`,controls:true,muted:true,playsInline:true,className:`mint-w-full mint-rounded-xl`,style:{aspectRatio:`16 / 10`},preload:`metadata`,controlsList:`nodownload noremoteplayback`,poster:`/media/agents-knowledge-base/poster.webp`,children:_jsx(`source`,{src:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/video.webm?fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=708cf0c8d93f232e90b67edff7c33235`,type:`video/webm; codecs=\"av01.0.09M.08\"`,\"data-path\":`media/agents-knowledge-base/video.webm`})})}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Pick knowledge bases`,children:[_jsxs(_components.p,{children:[`In the agent editor, click `,_jsx(_components.strong,{children:`Knowledge Base`}),`, then `,_jsx(_components.strong,{children:`Select Knowledge Base`}),`, and tick one or more. Each tick attaches it at once: “Knowledge base attached successfully”. The button then shows the count.`]}),_jsx(Frame,{caption:`Two knowledge bases attached`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=4a6d3baf2bbe2e6ae063239a145134cf`,alt:`Knowledge Base panel reading Please select the knowledge base(s), a button showing Knowledge bases selected 2, and EMI payment FAQ and Loan policy 2026 listed below with trash icons`,\"data-og-width\":`548`,width:`548`,\"data-og-height\":`394`,height:`394`,\"data-path\":`media/agents-knowledge-base/attached.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?w=280\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=9416cd232314604cd6545da6d6102c8f 280w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?w=560\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=c44c65b7b07c465ad16760026ae4f328 560w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?w=840\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=10d5c7c2a42c8dbf972c36fb867103ab 840w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=467acf6c60f68c6fe3a7c6a7071361dc 1100w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=973ca8897b527dcd622aded975a117cb 1650w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/attached.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=62532905b21d7f9c9c07814fb8690525 2500w`})})]}),_jsxs(Step,{title:`Detach`,children:[_jsx(_components.p,{children:`Click the trash icon on an attached knowledge base, or untick it in the list: “Knowledge base detached successfully”.`}),_jsxs(Check,{children:[`Attached knowledge bases are listed below the button and appear under `,_jsx(_components.strong,{children:`Knowledge Bases`}),` when you type `,_jsx(_components.code,{children:`@`}),` in the `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt`,children:`prompt`}),`.`]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Add Knowledge Base`}),` at the bottom of the list opens the Knowledge base page to create a new one (`,_jsx(_components.a,{href:`/documentation/inventory/knowledge-base#create-a-knowledge-base`,children:`Create a knowledge base`}),`). If the button reads `,_jsx(_components.strong,{children:`No knowledge bases found`}),`, the workspace has none yet; create one there first.`]}),`\n`,_jsxs(_components.p,{children:[`You can also attach knowledge bases while you `,_jsx(_components.a,{href:`/documentation/build-agents/agents/create-an-agent`,children:`create the agent`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Attachments belong to the version you are editing. On an agent with several `,_jsx(_components.a,{href:`/documentation/build-agents/test-and-improve/drafts-and-versions`,children:`versions`}),`, attach the knowledge base to each version that needs it.`]}),`\n`,_jsx(Heading,{level:`3`,id:`multi-prompt-agents`,children:`Multi-prompt agents`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.a,{href:`/documentation/build-agents/agents/multi-prompt-agents/overview`,children:`multi-prompt agent`}),` has knowledge bases at two levels:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Where`}),_jsx(_components.th,{children:`Applies to`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Global settings → Knowledge base`}),` (`,_jsx(_components.a,{href:`/documentation/build-agents/agents/multi-prompt-agents/global-settings#global-settings`,children:`Global Settings`}),`)`]}),_jsx(_components.td,{children:`The whole agent`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`An `,_jsx(_components.strong,{children:`Agent`}),` node’s `,_jsx(_components.strong,{children:`Knowledge base`}),` section (`,_jsx(_components.a,{href:`/documentation/build-agents/agents/multi-prompt-agents/node-types-and-connections#node-types`,children:`node types`}),`)`]}),_jsx(_components.td,{children:`That node only`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Changes go into the draft, so `,_jsx(_components.a,{href:`/documentation/build-agents/test-and-improve/drafts-and-versions#publish-changes-on-a-multi-prompt-agent`,children:`publish the agent`}),` for callers to get them. Once a node has a knowledge base or an on-call tool, it also shows `,_jsx(_components.strong,{children:`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.`]}),`\n`,_jsx(Heading,{level:`2`,id:`mention-it-in-the-prompt`,children:`Mention it in the prompt`}),`\n`,_jsxs(_components.p,{children:[`Type `,_jsx(_components.code,{children:`@`}),` in the prompt and pick the knowledge base from the `,_jsx(_components.strong,{children:`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 `,_jsx(_components.code,{children:`loan_faqs`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`For questions about interest rates, eligibility or documents, answer from @loan_faqs.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`If the answer is not there, say you will check and have an advisor call back.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Frame,{caption:`Attached knowledge bases in the @ menu`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=aefd73065225b5ceeb99ddded88e73a4`,alt:`Mention menu with Custom Variables, then a Knowledge Bases group listing EMI payment FAQ and Loan policy 2026, then Logic`,\"data-og-width\":`558`,width:`558`,\"data-og-height\":`860`,height:`860`,\"data-path\":`media/agents-knowledge-base/kb-in-menu.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?w=280\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=c1a4d5a168ff529b11997e5ad5ba0e74 280w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?w=560\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=4ab97a45d14a1644febd2baaba0e0e57 560w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?w=840\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=573e83a6077a8ee5140dda2b8bd57c5d 840w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=cdaf8769726c6ffbf7043332cad42645 1100w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=8f3d60e7960e73b9cf8f2ae573560ad4 1650w, https://mintcdn.com/ringgai-0da73d20/zhzhS2waLZvF8qXk/media/agents-knowledge-base/kb-in-menu.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=zhzhS2waLZvF8qXk\u0026q=85\u0026s=3883251de9e1aa6a7d1c031a9f6b017d 2500w`})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/documentation/build-agents/customize-agent-behaviour/agent-prompt`,children:`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.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-agent-uses-it-in-a-call`,children:`How the agent uses it in a call`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.strong,{children:`Exact match`}),` (`,_jsx(_components.a,{href:`/documentation/inventory/knowledge-base#structured-data-and-column-configuration`,children:`column configuration`}),`), the lookup matches the exact value, such as an order ID the caller reads out.`]}),`\n`,_jsx(Heading,{level:`2`,id:`do-this-with-the-api`,children:`Do this with the API`}),`\n`,_jsxs(_components.p,{children:[`Call `,_jsx(_components.a,{href:`/api-reference/agents/edit-assistant`,children:`Edit Assistant`}),` (`,_jsx(_components.code,{children:`PATCH /agent/v1`}),`) with `,_jsx(_components.code,{children:`operation`}),` set to `,_jsx(_components.code,{children:`attach_kb`}),` or `,_jsx(_components.code,{children:`remove_kb`}),` and the `,_jsx(_components.code,{children:`kb_id`}),`, once per knowledge base. Send your `,_jsx(_components.a,{href:`/documentation/manage-account/api-key`,children:`API key`}),` in `,_jsx(_components.code,{children:`X-API-KEY`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://prod-api.ringg.ai/ca/api/v0/agent/v1\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-KEY: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RINGG_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"operation\": \"attach_kb\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"agent_id\": \"b1972188-038e-4605-916c-3926e9d7bde4\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"kb_id\": \"550e8400-e29b-41d4-a716-446655440000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Get the `,_jsx(_components.code,{children:`kb_id`}),` from `,_jsx(_components.a,{href:`/api-reference/inventory/knowledge-bases/get-all-knowledge-bases`,children:`Get All Knowledge Bases`}),`, and the `,_jsx(_components.code,{children:`agent_id`}),` from the editor (`,_jsx(_components.a,{href:`/documentation/build-agents/agents/agent-types#find-the-agent-id`,children:`Find an agent’s ID`}),`). To create knowledge bases by API, see `,_jsx(_components.a,{href:`/api-reference/inventory/knowledge-bases/create-knowledge-base`,children:`Create Knowledge Base`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`test-it`,children:`Test it`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Test the knowledge base alone`,children:_jsxs(_components.p,{children:[`Ask your questions in the knowledge base’s test chat first (`,_jsx(_components.a,{href:`/documentation/inventory/knowledge-base#test-it-in-chat`,children:`Test it in chat`}),`). If the answer is wrong there, fix the data before you test the agent.`]})}),_jsx(Step,{title:`Test the agent`,children:_jsxs(_components.p,{children:[`Place a test call or chat (`,_jsx(_components.a,{href:`/documentation/build-agents/test-and-improve/test-an-agent`,children:`Test an agent`}),`) and ask the same questions, phrased the way a customer would.`]})}),_jsxs(Step,{title:`Read the transcript`,children:[_jsxs(_components.p,{children:[`Open the call in `,_jsx(_components.a,{href:`/documentation/monitor/logs#the-call-panel`,children:`Logs`}),` and read the `,_jsx(_components.strong,{children:`Transcript`}),` tab to see exactly what the agent answered.`]}),_jsx(Check,{children:`The agent’s answers match the knowledge base’s test chat.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsx(Card,{title:`Add tools`,icon:`wrench`,href:`/documentation/build-agents/customize-agent-behaviour/tools/overview`,horizontal:true,children:_jsx(_components.p,{children:`Connect the agent to your APIs before, during and after a call.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Attach a knowledge base","sidebarTitle":"Attach a knowledge base","description":"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.","og:title":"Attach a knowledge base to a Ringg AI agent","href":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Attach or detach a knowledge base","slug":"attach-or-detach-a-knowledge-base","depth":2,"children":[{"title":"Multi-prompt agents","slug":"multi-prompt-agents","depth":3,"children":[]}]},{"title":"Mention it in the prompt","slug":"mention-it-in-the-prompt","depth":2,"children":[]},{"title":"How the agent uses it in a call","slug":"how-the-agent-uses-it-in-a-call","depth":2,"children":[]},{"title":"Do this with the API","slug":"do-this-with-the-api","depth":2,"children":[]},{"title":"Test it","slug":"test-it","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ringgai-0da73d20/45c33e65ef05fabf/hairline.js"],"dynamicCss":".mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}","subdomain":"ringgai-0da73d20","siteName":"Ringg AI","title":"Attach a knowledge base to a Ringg AI agent","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-13T11:53:24.635Z","originalFileLocation":"documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Attach a knowledge base to a Ringg AI agent\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ringg AI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Customize+agent+behaviour\u0026amp;title=Attach+a+knowledge+base\u0026amp;description=Attach+or+detach+knowledge+bases+on+a+Ringg+AI+agent%2C+mention+them+in+the+prompt+with+%40%2C+add+query+phrases%2C+and+test+that+the+agent+answers+from+your+data.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=60b6dcef45044cf030b54339e52661fb5d48b0b49470a08c31cc732ced009d7e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Attach a knowledge base to a Ringg AI agent\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ringgai-0da73d20.mintlify.site/_mintlify/api/og/v2?division=Customize+agent+behaviour\u0026amp;title=Attach+a+knowledge+base\u0026amp;description=Attach+or+detach+knowledge+bases+on+a+Ringg+AI+agent%2C+mention+them+in+the+prompt+with+%40%2C+add+query+phrases%2C+and+test+that+the+agent+answers+from+your+data.\u0026amp;theme=737b8671029ef070100737b1\u0026amp;signature=60b6dcef45044cf030b54339e52661fb5d48b0b49470a08c31cc732ced009d7e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ringgai-0da73d20/p7P0VdTXwvUPgoLE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ringg AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A0A0B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ringg.ai/#organization\",\"name\":\"Ringg AI\",\"legalName\":\"Stoic AI Private Limited\",\"url\":\"https://www.ringg.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://assets.ringg.ai/images/logo/logo.svg\"},\"sameAs\":[\"https://x.com/ringg_ai\",\"https://www.linkedin.com/company/ringg\",\"https://www.youtube.com/@RinggAI\",\"https://www.instagram.com/ringg_ai\",\"https://discord.gg/YuEnb8Vsca\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ringg.ai#website\",\"name\":\"Ringg AI\",\"url\":\"https://docs.ringg.ai\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base#webpage\",\"url\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base\",\"name\":\"Attach a knowledge base\",\"description\":\"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.\",\"dateModified\":\"2026-10-13T11:53:24.635Z\",\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Build agents\",\"item\":\"https://docs.ringg.ai/documentation/build-agents/agents/agent-types\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customize agent behaviour\",\"item\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/agent-prompt\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Attach a knowledge base\",\"item\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base#article\",\"headline\":\"Attach a knowledge base\",\"name\":\"Attach a knowledge base\",\"description\":\"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.\",\"url\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ringg.ai/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base#webpage\"},\"dateModified\":\"2026-10-13T11:53:24.635Z\",\"publisher\":{\"@id\":\"https://www.ringg.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ringg.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ringg AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ringg AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base.md","siteName":"Ringg AI","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/get-started/introduction"}]},{"tab":"Documentation","pages":[{"title":"Ringg AI documentation","sidebarTitle":"Introduction","icon":"book-open","href":"/documentation/introduction"},{"group":"Build agents","icon":"bot","pages":[{"group":"Agents","pages":[{"title":"Agent types","sidebarTitle":"Agent types","href":"/documentation/build-agents/agents/agent-types"},{"title":"Create an agent","sidebarTitle":"Create an agent","href":"/documentation/build-agents/agents/create-an-agent"},{"group":"Multi-prompt agents","pages":[{"title":"Multi-prompt agents","sidebarTitle":"Overview","href":"/documentation/build-agents/agents/multi-prompt-agents/overview"},{"title":"Node types and connections","sidebarTitle":"Node types and connections","href":"/documentation/build-agents/agents/multi-prompt-agents/node-types-and-connections"},{"title":"Multi-prompt global settings","sidebarTitle":"Global settings","href":"/documentation/build-agents/agents/multi-prompt-agents/global-settings"},{"title":"Test and convert multi-prompt agents","sidebarTitle":"Test and convert","href":"/documentation/build-agents/agents/multi-prompt-agents/test-and-convert"}]},{"group":"WhatsApp agents","tag":"NEW","pages":[{"title":"WhatsApp agents","sidebarTitle":"Overview","href":"/documentation/build-agents/agents/whatsapp-agents/overview"},{"title":"Create a WhatsApp agent","sidebarTitle":"Create an agent","href":"/documentation/build-agents/agents/whatsapp-agents/create-an-agent"},{"title":"WhatsApp Flows","sidebarTitle":"Flows","href":"/documentation/build-agents/agents/whatsapp-agents/flows"},{"title":"Build WhatsApp Flows in Ringg","sidebarTitle":"Flow builder","href":"/documentation/build-agents/agents/whatsapp-agents/flow-builder"},{"title":"WhatsApp Flows with live data","sidebarTitle":"Flows with live data","href":"/documentation/build-agents/agents/whatsapp-agents/flows-live-data"},{"title":"Live data from your server","sidebarTitle":"Live data from your server","href":"/documentation/build-agents/agents/whatsapp-agents/flows-your-server"}]}]},{"group":"Customize agent behaviour","pages":[{"title":"Agent prompt","sidebarTitle":"Agent prompt","href":"/documentation/build-agents/customize-agent-behaviour/agent-prompt"},{"title":"Voice and language","sidebarTitle":"Voice and language","href":"/documentation/build-agents/customize-agent-behaviour/voice-and-language"},{"title":"Custom variables","sidebarTitle":"Custom variables","description":"Add custom variables to a Ringg AI agent, mention them in the prompt with @, and fill them per call by API, per contact from a campaign CSV, or from tools.","href":"/documentation/build-agents/customize-agent-behaviour/custom-variables"},{"title":"Attach a knowledge base","sidebarTitle":"Attach a knowledge base","href":"/documentation/build-agents/customize-agent-behaviour/attach-a-knowledge-base"},{"group":"Tools","pages":[{"title":"Tools","sidebarTitle":"Overview","description":"How Ringg AI agent tools work: the pre-call, on-call and post-call phases, the kinds of tool on each, using on-call tools in the prompt, and managing tools from an AI assistant.","href":"/documentation/build-agents/customize-agent-behaviour/tools/overview"},{"title":"API tools","sidebarTitle":"API tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/api-tools"},{"title":"Integration tools","sidebarTitle":"Integration tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/integration-tools"},{"title":"System tools","sidebarTitle":"System tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/system-tools"},{"title":"Function tools and conditions","sidebarTitle":"Function tools and conditions","href":"/documentation/build-agents/customize-agent-behaviour/tools/function-tools-and-conditions"},{"title":"Post-call tools","sidebarTitle":"Post-call tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/post-call-tools"},{"title":"Workspace tools","sidebarTitle":"Workspace tools","href":"/documentation/build-agents/customize-agent-behaviour/tools/workspace-tools"},{"title":"WhatsApp tools","sidebarTitle":"WhatsApp tools","tag":"NEW","href":"/documentation/build-agents/customize-agent-behaviour/tools/whatsapp-tools"}]},{"title":"Call settings","sidebarTitle":"Call settings","href":"/documentation/build-agents/customize-agent-behaviour/call-settings"},{"title":"Advanced Analysis","sidebarTitle":"Advanced Analysis","href":"/documentation/build-agents/customize-agent-behaviour/advanced-analysis"},{"title":"Event Subscription","sidebarTitle":"Event Subscription","href":"/documentation/build-agents/customize-agent-behaviour/event-subscription"},{"group":"Webhooks","pages":[{"title":"Webhook setup and errors","sidebarTitle":"Setup and errors","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/setup-and-errors"},{"title":"Call events","sidebarTitle":"Call events","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/call-events"},{"title":"WhatsApp chat events","sidebarTitle":"WhatsApp chat events","tag":"NEW","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/whatsapp-chat-events"},{"title":"Webhook field reference","sidebarTitle":"Field reference","href":"/documentation/build-agents/customize-agent-behaviour/webhooks/field-reference"}]}]},{"group":"Test and improve","pages":[{"title":"Test an agent","sidebarTitle":"Test an agent","href":"/documentation/build-agents/test-and-improve/test-an-agent"},{"title":"Drafts and versions","sidebarTitle":"Drafts and versions","href":"/documentation/build-agents/test-and-improve/drafts-and-versions"}]},{"group":"Workflows","pages":[{"title":"Workflows","sidebarTitle":"Overview","href":"/documentation/build-agents/workflows/overview"},{"title":"Build a workflow","sidebarTitle":"Build a workflow","href":"/documentation/build-agents/workflows/build-a-workflow"},{"title":"Test and publish a workflow","sidebarTitle":"Test and publish","href":"/documentation/build-agents/workflows/test-and-publish"},{"title":"Workflow block reference","sidebarTitle":"Block reference","href":"/documentation/build-agents/workflows/block-reference"}]}]},{"group":"Inventory","icon":"package","pages":[{"title":"Knowledge base","sidebarTitle":"Knowledge base","href":"/documentation/inventory/knowledge-base"},{"group":"Tools (integrations)","pages":[{"title":"Connect an app","sidebarTitle":"Connect an app","href":"/documentation/inventory/tools-integrations/connect-an-app"},{"title":"Connect WhatsApp","sidebarTitle":"Connect WhatsApp","tag":"NEW","href":"/documentation/inventory/tools-integrations/connect-whatsapp"}]},{"group":"Phone numbers","pages":[{"title":"Phone numbers","sidebarTitle":"Overview","href":"/documentation/inventory/phone-numbers/overview"},{"title":"Buy or import a number","sidebarTitle":"Buy or import a number","href":"/documentation/inventory/phone-numbers/buy-or-import-a-number"},{"group":"Your own telephony","pages":[{"title":"Bring your own telephony","sidebarTitle":"BYOT overview","href":"/documentation/inventory/phone-numbers/your-own-telephony/byot-overview"},{"title":"SIP trunking","sidebarTitle":"SIP trunking","href":"/documentation/inventory/phone-numbers/your-own-telephony/sip-trunking"},{"title":"Plivo","sidebarTitle":"Plivo","href":"/documentation/inventory/phone-numbers/your-own-telephony/plivo"},{"title":"Exotel","sidebarTitle":"Exotel","href":"/documentation/inventory/phone-numbers/your-own-telephony/exotel"},{"title":"Twilio","sidebarTitle":"Twilio","href":"/documentation/inventory/phone-numbers/your-own-telephony/twilio"},{"title":"Telnyx","sidebarTitle":"Telnyx","href":"/documentation/inventory/phone-numbers/your-own-telephony/telnyx"},{"title":"InTalk","sidebarTitle":"InTalk","href":"/documentation/inventory/phone-numbers/your-own-telephony/intalk"},{"title":"Ameyo","sidebarTitle":"Ameyo","href":"/documentation/inventory/phone-numbers/your-own-telephony/ameyo"},{"title":"Ozonetel","sidebarTitle":"Ozonetel","href":"/documentation/inventory/phone-numbers/your-own-telephony/ozonetel"},{"title":"New provider requirements","sidebarTitle":"New provider requirements","href":"/documentation/inventory/phone-numbers/your-own-telephony/new-provider-requirements"}]},{"title":"Number pools","sidebarTitle":"Number pools","href":"/documentation/inventory/phone-numbers/number-pools"},{"title":"Inbound agent number","sidebarTitle":"Inbound agent number","href":"/documentation/inventory/phone-numbers/inbound-agent-number"}]}]},{"group":"Deploy","icon":"rocket","pages":[{"group":"Campaigns","pages":[{"title":"Campaigns","sidebarTitle":"Overview","href":"/documentation/deploy/campaigns/overview"},{"title":"Create a campaign","sidebarTitle":"Create a campaign","href":"/documentation/deploy/campaigns/create-a-campaign"},{"title":"Workflow campaign","sidebarTitle":"Workflow campaign","href":"/documentation/deploy/campaigns/workflow-campaign"},{"title":"Campaigns by API","sidebarTitle":"Campaigns by API","href":"/documentation/deploy/campaigns/campaigns-by-api"},{"title":"Calling list","sidebarTitle":"Calling list","href":"/documentation/deploy/campaigns/calling-list"},{"title":"Manage a campaign","sidebarTitle":"Manage a campaign","href":"/documentation/deploy/campaigns/manage-a-campaign"}]},{"group":"Web and apps","pages":[{"group":"Web widget","pages":[{"title":"Web widget","sidebarTitle":"Overview","href":"/documentation/deploy/web-and-apps/web-widget/overview"},{"title":"Web widget configuration","sidebarTitle":"Configuration","href":"/documentation/deploy/web-and-apps/web-widget/configuration"},{"title":"Web widget events","sidebarTitle":"Events","href":"/documentation/deploy/web-and-apps/web-widget/events"},{"title":"Chat mode","sidebarTitle":"Chat mode","href":"/documentation/deploy/web-and-apps/web-widget/chat-mode"},{"title":"Chat components","sidebarTitle":"Components","href":"/documentation/deploy/web-and-apps/web-widget/components"},{"title":"Chat component data","sidebarTitle":"Data","href":"/documentation/deploy/web-and-apps/web-widget/data"},{"title":"Chat component recipes","sidebarTitle":"Recipes","href":"/documentation/deploy/web-and-apps/web-widget/recipes"},{"title":"Web widget styling","sidebarTitle":"Styling","href":"/documentation/deploy/web-and-apps/web-widget/styling"},{"title":"Web widget launch checklist","sidebarTitle":"Launch checklist","href":"/documentation/deploy/web-and-apps/web-widget/launch-checklist"}]},{"group":"Mobile apps","pages":[{"title":"Mobile app install","sidebarTitle":"Install","href":"/documentation/deploy/web-and-apps/mobile-apps/install"},{"title":"Mobile widget configuration","sidebarTitle":"Configuration","href":"/documentation/deploy/web-and-apps/mobile-apps/configuration"},{"title":"Mobile widget events","sidebarTitle":"Events","href":"/documentation/deploy/web-and-apps/mobile-apps/events"}]}]},{"group":"WhatsApp","tag":"NEW","pages":[{"title":"Start a conversation","sidebarTitle":"Start a conversation","href":"/documentation/deploy/whatsapp/start-a-conversation"},{"title":"WhatsApp Relay","sidebarTitle":"Relay overview","href":"/documentation/deploy/whatsapp/relay-overview"},{"title":"WhatsApp Relay integration guide","sidebarTitle":"Relay integration guide","href":"/documentation/deploy/whatsapp/relay-integration-guide"},{"title":"WhatsApp Relay troubleshooting","sidebarTitle":"Relay troubleshooting","href":"/documentation/deploy/whatsapp/relay-troubleshooting"}]}]},{"group":"Monitor","icon":"chart-line","pages":[{"title":"Logs","sidebarTitle":"Logs","href":"/documentation/monitor/logs"},{"title":"Analytics","sidebarTitle":"Analytics","href":"/documentation/monitor/analytics"},{"title":"Evals","sidebarTitle":"Evals","href":"/documentation/monitor/evals"},{"title":"Alerts","sidebarTitle":"Alerts","href":"/documentation/monitor/alerts"}]},{"group":"Manage account","icon":"settings","pages":[{"title":"Members","sidebarTitle":"Members","href":"/documentation/manage-account/members"},{"title":"API key","sidebarTitle":"API key","href":"/documentation/manage-account/api-key"},{"title":"Billing","sidebarTitle":"Billing","href":"/documentation/manage-account/billing"},{"title":"Call limits","sidebarTitle":"Call limits","href":"/documentation/manage-account/call-limits"},{"group":"Ringg Spaces","pages":[{"title":"Ringg Spaces","sidebarTitle":"Overview","href":"/documentation/manage-account/ringg-spaces/overview"},{"title":"Create and manage Ringg Spaces","sidebarTitle":"Create and manage","href":"/documentation/manage-account/ringg-spaces/create-and-manage"},{"title":"Ringg Spaces by API","sidebarTitle":"Ringg Spaces by API","href":"/documentation/manage-account/ringg-spaces/ringg-spaces-by-api"}]}]},{"group":"Ringg Labs","icon":"flask-conical","pages":[{"group":"Parrot STT","pages":[{"title":"Parrot STT Python SDK","sidebarTitle":"Python SDK","href":"/documentation/ringg-labs/parrot-stt/python-sdk"},{"title":"Parrot STT on TrueFoundry","sidebarTitle":"TrueFoundry","href":"/documentation/ringg-labs/parrot-stt/truefoundry"}]}]}]},{"tab":"Analytics platform","pages":[{"title":"Analytics platform","href":"/analytics-platform/introduction"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction/quickstart"}]},{"tab":"Resources","menu":[{"item":"MCP server","description":"Let Claude, ChatGPT or Cursor work in your workspace, or search these docs","pages":[{"title":"MCP server","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]},{"item":"Learn","description":"Lessons that build a payment-reminder system end to end","pages":[{"title":"Learn","href":"/resources/learn/all-lessons"}]},{"item":"Security","description":"How Ringg protects your data, and what to do on your side","pages":[{"title":"Security","href":"/resources/security/security"}]},{"item":"Changelog","description":"New features, API changes and new guides","pages":[{"title":"Changelog","href":"/resources/changelog/changelog"}]}],"pages":[{"title":"Resources","href":"/resources/mcp-server/docs-mcp-server/mcp-for-ai-assistants"}]}]},"basePath":"","title":"Attach a knowledge base to a Ringg AI agent","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}