Chatsistant is the first and most powerful no-code AI Chat framework that
implements a multi-agent architecture. Multiple AI Agents work together in a coordinated orchestration
to enable advanced workflow automations.
We present this guide to help you understand how our Agents work together, as well as share
with you some best practices surrounding multi-agent chatbot design.All Agents have two states:
Active: Agent is “Connected”. It is live and running.
Inactive: Agent is “Disabled”. It does not do anything.
Only a single Agent engages with the user at any given time. Our AI Supervisor works in the background, in real time,
to decide which Agent processes the user’s inquiry when it comes in.
Agents are completely isolated from one another. This means that you cannot
tell Agent B what to do from inside Agent A, and you cannot tell the AI
Supervisor to “pass the baton” from Agent A to Agent B directly. The AI
Supervisor cannot be instructed on what to do using natural language.
The AI Supervisor assigns user queries to AI Agents based on the Agent description. This means that if
you have only a single AI Agent, then you don’t need a very good description. But if you are working with
multiple AI Agents, then you should have as explict a description as possible.
Agent Description - What kind of tasks should the Agent do?
Agent Prompt - How should the Agent perform its tasks?
AI Agent description is different from the Prompt. Description should tell the
AI Supervisor what the Agent is designed to do at a high level, focusing on
the type of user queries it should handle. Prompt is a set of instructions
telling the AI Agent how to behave.
Good Agent descriptions should answer the question “What type of queries should the Agent handle?”
More specifically, Agent descriptions should encompass all relevant “user intents” that it is supposed to handle.Agent descriptions should not include details about “how the Agent performs its job”.
That part should be reserved for the Agent’s Prompt.Here are some examples of good Agent descriptions:
Chatsistant Support
Embody the role of “Chatsistant Expert,” a specialized guide for Chatsistant. Your main objective is to assist users with answering Chatsistant-related questions related to:
Use cases
Features and capabilities
Data security
Pricing
AI Agents and multi-Agent architecture
User identity verification
Chunk curation
Function calling
Partnership program
Custom domains
Tokens
All intents handled by this Agent should be related to Chatsistant.
Product Expert
The Product Expert handles any user queries related to Example Company’s
products. This includes questions regarding: - Product availability - Product
specifications - Price - Shipping location - Warranty - Return policy -
Disclaimers, legal notices, and warning labels
Order Status Assistant
The Order Status Assistant handles any user queries related to an order’s status. This includes questions regarding:
Product package tracking
Current package location
Estimated time of delivery
Late delivery compensation
So what makes for a good multi-agent chatbot design? How can I ensure that all my user intents are handled by the appropriate Agent?In general, a multi-agent architecture is great for having specialized AI Agents work together as a team. Each AI Agent
can be trained on a different set of source data, be powered by a different LLM, have a different Prompt, or even be given
different tools (functions). It is much more effective than dumping everything into a single Agent.On the surface, your users will not know that they are engaging with multiple AI Agents when talking to the chatbot,
since all of the complex orchestration takes place seamlessly behind the scenes. With the right setup, they will feel
as though they are talking to a human instead of a machine. A multi-agent chatbot has the potential to be much more
powerful than single-agent ones like ChatGPT.In our AI Supervisor routing design, we use an algorithm that balances latency with performance.
It will not always give you 100% accuracy, but you can get pretty close if you design your chatbots effectively.
Debugging the chatbot
If you notice that the chatbot is not responding to your expectations, then there may be two causes.
The wrong Agent may have been assigned to handle the incoming user query.
The Agent itself may not be optimally configured.
To find out whether your intended Agent has been selected to handle the user’s query, go to “Inbox” and turn on debug mode.
Toggle it on here:
Under “Active Agent”, you will see the Agent that generated the response. Please note that you will only see “Active Agent” metadata
if you have more than one connected AI Agents.If the Agent that handled the user query was not the correct one, you can return to Agent configuration and update its name, description,
or prompt.If the correct Agent handled the user query but the response was not what you expected, then the issue resides within the Agent itself.
You will then need to update the Agent configuration. The most straightforward way to fix a response is by revising the AI’s answer directly:
This ensures that the chatbot will generate an answer based on what you revised every time it encounters the question in the future, assuming
the same Agent was chosen to respond to the query.If you’d like to make the Agent more robust and consistent in general, you can curate the training data, choose a more powerful LLM, or be more
explicit in your base prompt.To learn some best practices for training the chatbot, see best practices for preparing training dataTo learn more about fine-tuning Agent intents, please check out the article Fine-Tuning Agent Intents.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chatsistant API","colors":{"primary":"#2E3F51","light":"#516F90","dark":"#0D001D"},"logo":{"light":"https://mintcdn.com/chatsistant/cM2IU8RXqv-3TQFG/logo/light.svg?fit=max\u0026auto=format\u0026n=cM2IU8RXqv-3TQFG\u0026q=85\u0026s=9d3655b647b4e05dab0f447b19ea9b1b","dark":"https://mintcdn.com/chatsistant/cM2IU8RXqv-3TQFG/logo/dark.svg?fit=max\u0026auto=format\u0026n=cM2IU8RXqv-3TQFG\u0026q=85\u0026s=0c4df0d7d9110175c51d84b69f63c2e6","href":"https://chatsistant.com"},"favicon":"https://mintcdn.com/chatsistant/bw0W4PPFP0FNqFg-/logo/favicon.png?fit=max\u0026auto=format\u0026n=bw0W4PPFP0FNqFg-\u0026q=85\u0026s=39134c3bd2c163914fc74c48dd7dcd76","api":{"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://app.chatsistant.com/api"}},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#111827"}},"navbar":{"links":[{"href":"mailto:hello@chatsistant.com","label":"Support"}],"primary":{"type":"button","label":"Get started","href":"https://chatsistant.com"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"chatsistant","hasAudioNarration":false,"actualSubdomain":"chatsistant","customDomains":["docs.chatsistant.com"],"gitSource":{"type":"github","owner":"chatsistant","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6af3fb189d3cc29fad128d11","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API References","count":38},{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Data Sources","count":9},{"language":"default","tag":"Chatbots","count":6},{"language":"default","tag":"Agents","count":5},{"language":"default","tag":"Session Messages","count":5},{"language":"default","tag":"Chatbot Sessions","count":5},{"language":"default","tag":"API Usage Guides","count":4},{"language":"default","tag":"Data Source Tags","count":4}]},"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":"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},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"multi-agents-chatbot","slug":"/multi-agents-chatbot","pageMetadata":{"title":"Multi-Agents Chatbot","description":null,"href":"/multi-agents-chatbot"},"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`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,Note,OptimizedImage}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Chatsistant is the first and most powerful no-code AI Chat framework that\nimplements a multi-agent architecture. Multiple AI Agents work together in a coordinated orchestration\nto enable advanced workflow automations.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=7bbff21948a745c9bf2b5bc8f3bc3c92`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`769`,height:`769`,\"data-path\":`images/multi-agents-chatbot-7.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?w=280\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=34b973297c3fab160c3ce7da066636e6 280w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?w=560\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=abc2c40ada800d8369e4cd28f8b6ab7e 560w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?w=840\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=46f18cd6bce8ad66227f711f6e6c4616 840w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=e4f130dd51f9205aa645316a7598945c 1100w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=96566ec06adc7778893fe31ecc04f612 1650w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-7.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=81d05419318a76d499b8fde00563bd82 2500w`})}),`\n`,_jsx(_components.p,{children:`We present this guide to help you understand how our Agents work together, as well as share\nwith you some best practices surrounding multi-agent chatbot design.`}),`\n`,_jsx(_components.p,{children:`All Agents have two states:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Active:`}),` Agent is “Connected”. It is live and running.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Inactive:`}),` Agent is “Disabled”. It does not do anything.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Only a single Agent engages with the user at any given time. Our AI Supervisor works in the background, in real time,\nto decide which Agent processes the user’s inquiry when it comes in.`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Agents are completely isolated from one another. This means that you cannot\ntell Agent B what to do from inside Agent A, and you cannot tell the AI\nSupervisor to “pass the baton” from Agent A to Agent B directly. The AI\nSupervisor cannot be instructed on what to do using natural language.`})}),`\n`,_jsx(_components.p,{children:`The AI Supervisor assigns user queries to AI Agents based on the Agent description. This means that if\nyou have only a single AI Agent, then you don’t need a very good description. But if you are working with\nmultiple AI Agents, then you should have as explict a description as possible.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Agent Description - What kind of tasks should the Agent do?`}),`\n`,_jsx(_components.li,{children:`Agent Prompt - How should the Agent perform its tasks?`}),`\n`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=32c5061659ccdce0214ac0839e3d8d7c`,\"data-og-width\":`1914`,width:`1914`,\"data-og-height\":`861`,height:`861`,\"data-path\":`images/multi-agents-chatbot-5.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?w=280\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=e48b9d499493aa30b528b61b318fcb69 280w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?w=560\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=2ded67e989a193f28eafeba96b5f874c 560w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?w=840\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=5dc0002d1025384c0adf92fb62fa15fe 840w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=8f0f1d01e111914ee2b2b3e6e0733fef 1100w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=06e240b69d1a883f136ad3f523709176 1650w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-5.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=cbed8d01570ab1ed8a13bcb7c6294afd 2500w`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`AI Agent description is different from the Prompt. Description should tell the\nAI Supervisor what the Agent is designed to do at a high level, focusing on\nthe type of user queries it should handle. Prompt is a set of instructions\ntelling the AI Agent how to behave.`})}),`\n`,_jsxs(_components.p,{children:[`Good Agent descriptions should answer the question `,_jsx(_components.strong,{children:`“What type of queries should the Agent handle?”`}),`\nMore specifically, Agent descriptions should encompass all relevant “user intents” that it is supposed to handle.`]}),`\n`,_jsxs(_components.p,{children:[`Agent descriptions `,_jsx(_components.strong,{children:`should not`}),` include details about “how the Agent performs its job”.\nThat part should be reserved for the Agent’s Prompt.`]}),`\n`,_jsx(_components.p,{children:`Here are some examples of good Agent descriptions:`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Chatsistant Support`,id:`chatsistant-support`,children:[_jsx(_components.p,{children:`Embody the role of “Chatsistant Expert,” a specialized guide for Chatsistant. Your main objective is to assist users with answering Chatsistant-related questions related to:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Use cases`}),`\n`,_jsx(_components.li,{children:`Features and capabilities`}),`\n`,_jsx(_components.li,{children:`Data security`}),`\n`,_jsx(_components.li,{children:`Pricing`}),`\n`,_jsx(_components.li,{children:`AI Agents and multi-Agent architecture`}),`\n`,_jsx(_components.li,{children:`User identity verification`}),`\n`,_jsx(_components.li,{children:`Chunk curation`}),`\n`,_jsx(_components.li,{children:`Function calling`}),`\n`,_jsx(_components.li,{children:`Partnership program`}),`\n`,_jsx(_components.li,{children:`Custom domains`}),`\n`,_jsx(_components.li,{children:`Tokens`}),`\n`]}),_jsx(_components.p,{children:`All intents handled by this Agent should be related to Chatsistant.`})]}),` `,_jsx(Accordion,{title:`Product Expert`,id:`product-expert`,children:_jsx(_components.p,{children:`The Product Expert handles any user queries related to Example Company’s\nproducts. This includes questions regarding: - Product availability - Product\nspecifications - Price - Shipping location - Warranty - Return policy -\nDisclaimers, legal notices, and warning labels`})}),_jsxs(Accordion,{title:`Order Status Assistant`,id:`order-status-assistant`,children:[_jsx(_components.p,{children:`The Order Status Assistant handles any user queries related to an order’s status. This includes questions regarding:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Product package tracking`}),`\n`,_jsx(_components.li,{children:`Current package location`}),`\n`,_jsx(_components.li,{children:`Estimated time of delivery`}),`\n`,_jsx(_components.li,{children:`Late delivery compensation`}),`\n`]})]})]}),`\n`,_jsx(_components.p,{children:`So what makes for a good multi-agent chatbot design? How can I ensure that all my user intents are handled by the appropriate Agent?`}),`\n`,_jsx(_components.p,{children:`In general, a multi-agent architecture is great for having specialized AI Agents work together as a team. Each AI Agent\ncan be trained on a different set of source data, be powered by a different LLM, have a different Prompt, or even be given\ndifferent tools (functions). It is much more effective than dumping everything into a single Agent.`}),`\n`,_jsx(_components.p,{children:`On the surface, your users will not know that they are engaging with multiple AI Agents when talking to the chatbot,\nsince all of the complex orchestration takes place seamlessly behind the scenes. With the right setup, they will feel\nas though they are talking to a human instead of a machine. A multi-agent chatbot has the potential to be much more\npowerful than single-agent ones like ChatGPT.`}),`\n`,_jsx(_components.p,{children:`In our AI Supervisor routing design, we use an algorithm that balances latency with performance.\nIt will not always give you 100% accuracy, but you can get pretty close if you design your chatbots effectively.`}),`\n`,_jsx(Heading,{level:`2`,id:`debugging-the-chatbot`,children:`Debugging the chatbot`}),`\n`,_jsx(_components.p,{children:`If you notice that the chatbot is not responding to your expectations, then there may be two causes.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`The wrong Agent may have been assigned to handle the incoming user query.`}),`\n`,_jsx(_components.li,{children:`The Agent itself may not be optimally configured.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`To find out whether your intended Agent has been selected to handle the user’s query, go to “Inbox” and turn on debug mode.\nToggle it on here:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=4e8c54f1dc4f6f257759963a5a6f01db`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`769`,height:`769`,\"data-path\":`images/multi-agents-chatbot-6.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?w=280\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=7e3bd3ba08e4f419fa24f7cc34787fce 280w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?w=560\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=277d14c2f1471421c3ce741192d7c3e4 560w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?w=840\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=3daea1226edf75c1cb437eaefcf8cf53 840w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=f4ee3e599c5051c515b24c565ad62607 1100w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=93e28608f8283e6633bfd4a511d82641 1650w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-6.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=18d6c1051566a08abc6dd942d3f98e9a 2500w`})}),`\n`,_jsx(_components.p,{children:`Under “Active Agent”, you will see the Agent that generated the response. Please note that you will only see “Active Agent” metadata\nif you have more than one connected AI Agents.`}),`\n`,_jsx(_components.p,{children:`If the Agent that handled the user query was not the correct one, you can return to Agent configuration and update its name, description,\nor prompt.`}),`\n`,_jsx(_components.p,{children:`If the correct Agent handled the user query but the response was not what you expected, then the issue resides within the Agent itself.\nYou will then need to update the Agent configuration. The most straightforward way to fix a response is by revising the AI’s answer directly:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=1346bc51a9a20abedc2f0295261b8271`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`769`,height:`769`,\"data-path\":`images/multi-agents-chatbot-4.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?w=280\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=f9b14baa45d6ef9c4c31020097314ec7 280w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?w=560\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=22d0ff816dfd545b93ceb38207bbc368 560w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?w=840\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=c27cf0dc6ad5e98a37d67820c3fad272 840w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?w=1100\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=8a44ecbdcf1f0dca0baa7a94badb019e 1100w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?w=1650\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=affa0ac00880ec86d4f1be9a9841335e 1650w, https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/multi-agents-chatbot-4.png?w=2500\u0026fit=max\u0026auto=format\u0026n=cqQo3vlCWcOFuvWd\u0026q=85\u0026s=55c1c8e752563537b2af570b498f500e 2500w`})}),`\n`,_jsx(_components.p,{children:`This ensures that the chatbot will generate an answer based on what you revised every time it encounters the question in the future, assuming\nthe same Agent was chosen to respond to the query.`}),`\n`,_jsx(_components.p,{children:`If you’d like to make the Agent more robust and consistent in general, you can curate the training data, choose a more powerful LLM, or be more\nexplicit in your base prompt.`}),`\n`,_jsxs(_components.p,{children:[`To learn some best practices for training the chatbot, see `,_jsx(_components.a,{href:`/best-practices`,children:`best practices for preparing training data`})]}),`\n`,_jsxs(_components.p,{children:[`To learn more about fine-tuning Agent intents, please check out the article `,_jsx(_components.a,{href:`fine-tuning-agent-intents`,children:`Fine-Tuning Agent Intents`}),`.`]})]})}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":"Multi-Agents Chatbot","description":null,"href":"/multi-agents-chatbot"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Debugging the chatbot","slug":"debugging-the-chatbot","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"chatsistant","siteName":"Chatsistant API","title":"Multi-Agents Chatbot - Chatsistant API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T04:18:48.063Z","originalFileLocation":"multi-agents-chatbot.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=\"system\"}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=\"application-name\" content=\"Chatsistant API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_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/chatsistant/jsSqGek8HR7LeVmL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Multi-Agents Chatbot - Chatsistant API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chatsistant API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.chatsistant.com/multi-agents-chatbot\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chatsistant.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Multi-Agents+Chatbot\u0026amp;theme=33abd71618eceb5ad98b303c\u0026amp;signature=7adde8246d9f7184cf0c926d7a49288064a0f0d436593a828c91a0abb14760f2\">\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=\"Multi-Agents Chatbot - Chatsistant API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chatsistant.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Multi-Agents+Chatbot\u0026amp;theme=33abd71618eceb5ad98b303c\u0026amp;signature=7adde8246d9f7184cf0c926d7a49288064a0f0d436593a828c91a0abb14760f2\">\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/chatsistant/jsSqGek8HR7LeVmL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chatsistant API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2E3F51\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.chatsistant.com/multi-agents-chatbot\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/multi-agents-chatbot.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.chatsistant.com/#organization\",\"name\":\"Chatsistant API\",\"url\":\"https://docs.chatsistant.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/chatsistant/cM2IU8RXqv-3TQFG/logo/light.svg?fit=max\u0026auto=format\u0026n=cM2IU8RXqv-3TQFG\u0026q=85\u0026s=9d3655b647b4e05dab0f447b19ea9b1b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.chatsistant.com#website\",\"name\":\"Chatsistant API\",\"url\":\"https://docs.chatsistant.com\",\"publisher\":{\"@id\":\"https://docs.chatsistant.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.chatsistant.com/multi-agents-chatbot#webpage\",\"url\":\"https://docs.chatsistant.com/multi-agents-chatbot\",\"name\":\"Multi-Agents Chatbot\",\"dateModified\":\"2026-11-11T04:18:48.063Z\",\"isPartOf\":{\"@id\":\"https://docs.chatsistant.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chatsistant.com/multi-agents-chatbot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chatsistant.com/multi-agents-chatbot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.chatsistant.com/creating-first-chatbot\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Multi-Agents Chatbot\",\"item\":\"https://docs.chatsistant.com/multi-agents-chatbot\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.chatsistant.com/multi-agents-chatbot#article\",\"headline\":\"Multi-Agents Chatbot\",\"name\":\"Multi-Agents Chatbot\",\"url\":\"https://docs.chatsistant.com/multi-agents-chatbot\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chatsistant.com/multi-agents-chatbot#webpage\"},\"dateModified\":\"2026-11-11T04:18:48.063Z\",\"publisher\":{\"@id\":\"https://docs.chatsistant.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.chatsistant.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chatsistant API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Chatsistant API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/multi-agents-chatbot.md","siteName":"Chatsistant API","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"}]},{"group":"Guides","pages":[{"title":"Create Your First Chatbot","href":"/creating-first-chatbot"},{"title":"Lead Collection","href":"/lead-collection"},{"title":"Human Support Escalation","href":"/human-support-escalation"},{"title":"Inbox Notifications","href":"/inbox-notifications"},{"title":"Conversation Labeling","description":null,"href":"/conversation-labeling"},{"title":"Multi-Agents Chatbot","href":"/multi-agents-chatbot"},{"title":"Fine Tuning Agent Intents","description":null,"href":"/fine-tuning-agent-intents"},{"title":"AI Supervisor Overrides","href":"/supervisor-overrides"},{"title":"Bring Your Own Key (BYOK) and Pricing","href":"/byok-pricing-guide"},{"title":"Working with Tables and CSV","href":"/working-with-tables"},{"title":"Best practices for preparing training data","href":"/best-practices"},{"title":"Background Agents","href":"/background-agents"},{"title":"Frustration Detection","href":"/frustration-detection"},{"title":"Why does my chatbot not answer correctly?","href":"/help"}]},{"group":"Function Calling","pages":[{"title":"RAG from an External Data Provider","href":"/rag-from-external-data-provider"}]},{"group":"Authentication Webhook","pages":[{"title":"User Identity Verification","href":"/user-identity"}]},{"group":"ChatGPT \u0026 MCP","pages":[{"title":"Chatsistant in ChatGPT (Native MCP)","href":"/mcp/overview"},{"title":"MCP Permissions \u0026 Protected Writes","href":"/mcp/permissions"}]}]},{"anchor":"API References","icon":"code","pages":[{"title":"API References","href":"/api-reference/api-key-setup"}]}]},"basePath":"","title":"Multi-Agents Chatbot - Chatsistant API","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}