When your chatbot has multiple AI Agents, our AI Supervisor automatically
assigns the most appropriate Agent to handle the user’s input queries. It does so by
first determining the user’s intent, then looks for the most
suitable Agent to help the user based on Agents’ names and descriptions.In our article Multi-Agent Chatbot, we covered some best practices on
Agent description writing and provided a number of examples. However, as comprehensive as the
AI Supervisor tries to be, there will still be scenarios where Agent descriptions do not sufficiently
cover all scenarios.When AI Agents are created or modified, we automatically generate a number of intents along
with example user queries to serve as reference for the AI Supervisor. These intents can be reviewed,
customized, or deleted through the AI Supervisor Settings interface. The AI Supervisor makes use
of these intents directly when evaluating each Agent’s specialty.To fine-tune Agent intents, go to AI Agents tab on the left navigation menu, then
click on AI Supervisor Settings:
Now head to the “Intents” tab:
Here, you will see the intents that have been automatically generated by the AI Supervisor based on
its interpretation of the Agent’s function. When a user submits a query, if you have more than one active
AI Agents set up, then the AI Supervisor will extract the user’s intent and try to find the closest match
across all active Agents.To add new intents, select the Agent that you want to fine-tune, then click “Add intent”.
Then, specify the intent along with a few example queries that users could input which demonstrates this intent.
Click Create.
You should see the intent added under “Fixed Intents”. You may need to scroll down to see the entire list.You can also edit AI-Generated Intents. Simply open the three-dot-menu next to the intent and select “Edit”.
After you save your edits, this intent will be moved to the “Fixed Intents” section.
Note: AI-Generated Intents will be overwritten each time you edit the Agent
name, description, or prompt. On the other hand, Fixed Intents are permanent
and only deleted if you manually do so.
For most use cases involving general Q&A, fine-tuning intents is not necessary. Our own internal tests have
shown that AI-generated intents are typically sufficient for good Agent routing.Allowing bot makers to control intent classification at a granular level empowers them to enhance chatbot performance
in situations where many AI Agents are involved, or where the chatbot requires a high degree of precision.When designing a multi-agent setup, we recommend keeping to a “MECE” approach.
“MECE” refers to - Mutually Exclusive, Collectively Exhaustive. In other words, no gaps, no overlaps.Ideally, you want the situation where:
User-facing Agent A handles:
intent class 1
intent class 2
intent class 3
etc.
User-facing Agent B handles:
intent class 10
intent class 11
intent class 12
etc.
and there is minimal overlap in intents among Agents.
All your Agents combined should cover all possible intents your users might have.But since you can’t ever account for all intents in the universe, and given the fact that intents are
presented in natural language which can have multiple permutations to express the same meaning,
there is no deterministic way to get 100% consistency. But you can get pretty close with an
optimized setup.During your chatbot’s operations, it is important to monitor incoming conversations and identify instances
where the wrong Agent was chosen to handle a user’s query. In these situations, we recommend that you make
use of our “Debug mode”. In this mode, if you have multiple user-facing Agents set up, you will see “Intent”
and “Active Agent” show up alongside every user query that underwent Agent routing.
If the incorrect Agent has been assigned, a quick and effective fix is to add the intent and the corresponding
user query to what should have been the correct Agent to handle the request within AI Supervisor Settings -> Intents.
This will ensure that if queries of the same type were to come up again, the correct Agent would be chosen.
Providing more examples for this intent will further reinforce the ability for the AI Supervisor to classify
similar cases in the future.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Chatsistant API","colors":{"primary":"#2E3F51","light":"#516F90","dark":"#0D001D"},"favicon":"/logo/favicon.png","logo":{"light":"https://mintcdn.com/chatsistant/bw0W4PPFP0FNqFg-/logo/light.svg?fit=max\u0026auto=format\u0026n=bw0W4PPFP0FNqFg-\u0026q=85\u0026s=f721e4cc50453f170fe167c8d5f9971f","dark":"https://mintcdn.com/chatsistant/bw0W4PPFP0FNqFg-/logo/dark.svg?fit=max\u0026auto=format\u0026n=bw0W4PPFP0FNqFg-\u0026q=85\u0026s=fcd6fd05fd8afca74097b05fde4c4007","href":"https://chatsistant.com"},"api":{"mdx":{"server":"https://app.chatsistant.com/api","auth":{"method":"bearer","name":null}}},"background":{"decoration":null,"color":{"light":null,"dark":"#111827"}},"navbar":{"links":[{"label":"Support","href":"mailto:hello@chatsistant.com"}],"primary":null},"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":""},"chroma":{"liveDeploymentHistoryId":"6a21f6212af1650193592d35","collectionId":"ff68fb2a-91c7-4dc0-a6ff-701a8cd7a98c","schemaVersion":"v2"},"entitlements":{},"buildId":"6ae924d5124fa040b9a800d7:success","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API References","count":38},{"language":"default","tag":"Documentation","count":17},{"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":"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":"vite-origin","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"fine-tuning-agent-intents","slug":"/fine-tuning-agent-intents","pageMetadata":{"title":"Fine Tuning Agent Intents","description":null,"href":"/fine-tuning-agent-intents"},"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`,blockquote:`blockquote`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Note,OptimizedImage}=_components;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:`When your chatbot has multiple AI Agents, our AI Supervisor automatically\nassigns the most appropriate Agent to handle the user’s input queries. It does so by\nfirst determining the user’s intent, then looks for the most\nsuitable Agent to help the user based on Agents’ names and descriptions.`}),`\n`,_jsxs(_components.p,{children:[`In our article `,_jsx(_components.a,{href:`multi-agents-chatbot`,children:`Multi-Agent Chatbot`}),`, we covered some best practices on\nAgent description writing and provided a number of examples. However, as comprehensive as the\nAI Supervisor tries to be, there will still be scenarios where Agent descriptions do not sufficiently\ncover all scenarios.`]}),`\n`,_jsx(_components.p,{children:`When AI Agents are created or modified, we automatically generate a number of intents along\nwith example user queries to serve as reference for the AI Supervisor. These intents can be reviewed,\ncustomized, or deleted through the AI Supervisor Settings interface. The AI Supervisor makes use\nof these intents directly when evaluating each Agent’s specialty.`}),`\n`,_jsx(_components.p,{children:`To fine-tune Agent intents, go to AI Agents tab on the left navigation menu, then\nclick on AI Supervisor Settings:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=231cb60ffac41ca0974531a94b6a0b63`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`769`,height:`769`,\"data-path\":`images/fine-tuning-agent-intents-5.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?w=280\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=16987cf1b9a131fef593f82a773ed2e5 280w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?w=560\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=c9676e652af8d8cab2c8dea75e4b0674 560w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?w=840\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=696ea0f64440a2fe8502ea9987c5ef0b 840w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=8b36b98b9432a555503e3fb4f460b0f1 1100w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=fd4bfd114eb3e1a457c07af5a7f04463 1650w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-5.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=212e8dfc40265b325f688ede384592ba 2500w`})}),`\n`,_jsx(_components.p,{children:`Now head to the “Intents” tab:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=5a66459b1d7ff8fe2164294429706b15`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`769`,height:`769`,\"data-path\":`images/fine-tuning-agent-intents-6.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?w=280\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=d0f8542abbf998a16aada247a1421bac 280w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?w=560\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=a52ff8f168f1f92e1c25472d7c9c542f 560w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?w=840\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=71e41555bd2184cdd1386e1de0405b90 840w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=7ffa6a596d8e90426dca2f685ff38214 1100w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=e0ab64a9247efa4dcd0de1076fff6d7d 1650w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-6.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=585e872b44e74819e45f90592a13cd01 2500w`})}),`\n`,_jsx(_components.p,{children:`Here, you will see the intents that have been automatically generated by the AI Supervisor based on\nits interpretation of the Agent’s function. When a user submits a query, if you have more than one active\nAI Agents set up, then the AI Supervisor will extract the user’s intent and try to find the closest match\nacross all active Agents.`}),`\n`,_jsx(_components.p,{children:`To add new intents, select the Agent that you want to fine-tune, then click “Add intent”.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=93661eff0881893a469a3af687a933de`,\"data-og-width\":`1404`,width:`1404`,\"data-og-height\":`859`,height:`859`,\"data-path\":`images/fine-tuning-agent-intents-7.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?w=280\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=a41f94a7c24dfb45ff7a27c0b83bfe5c 280w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?w=560\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=8ee4f76f55014bc4948286965ebce54d 560w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?w=840\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=553b6ac859adf31a57b83e4723713823 840w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=6573d8228a74cf3f4128bb6659a537c2 1100w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=9ac26cf79f5681c80452f34864d07040 1650w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-7.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=cd204d42b3ff765036ed08f4e75c9ff9 2500w`})}),`\n`,_jsx(_components.p,{children:`Then, specify the intent along with a few example queries that users could input which demonstrates this intent.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=8d7a29f07465ba59504a2c2fbc8d84fe`,\"data-og-width\":`523`,width:`523`,\"data-og-height\":`538`,height:`538`,\"data-path\":`images/fine-tuning-agent-intents-8.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?w=280\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=447150aa077f428079f60aacb0f6aa38 280w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?w=560\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=dc8bb32d1215c6afabd1899f880b5d5d 560w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?w=840\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=3cac5d900a2f7d51758a1266c7631020 840w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=615424f4bffd140c7bb1fe31c71557d9 1100w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=660e0255bc7217704c360513819a1100 1650w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-8.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=2277892e42e7df174965d52e03c0a211 2500w`})}),`\n`,_jsx(_components.p,{children:`Click Create.\nYou should see the intent added under “Fixed Intents”. You may need to scroll down to see the entire list.`}),`\n`,_jsx(_components.p,{children:`You can also edit AI-Generated Intents. Simply open the three-dot-menu next to the intent and select “Edit”.\nAfter you save your edits, this intent will be moved to the “Fixed Intents” section.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=30d16c42549d40ff89d26c9460dbe78e`,\"data-og-width\":`732`,width:`732`,\"data-og-height\":`742`,height:`742`,\"data-path\":`images/fine-tuning-agent-intents-9.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?w=280\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=2793fc64cca97fa4756f43ac0a7b82b9 280w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?w=560\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=39c1f60a0485c37609bcc1ea7672bdee 560w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?w=840\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=1c22fcb2c330281800ac1e4429849e92 840w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?w=1100\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=829dc7e84a9c49f00698cdbdc0f94936 1100w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?w=1650\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=9eabf55112ee05ebfc7c447663d56a50 1650w, https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/fine-tuning-agent-intents-9.png?w=2500\u0026fit=max\u0026auto=format\u0026n=yov5SpV13MsfHmGS\u0026q=85\u0026s=49d7db5bcd5022227a1eced76a1ac551 2500w`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Note: AI-Generated Intents will be overwritten each time you edit the Agent\nname, description, or prompt. On the other hand, Fixed Intents are permanent\nand only deleted if you manually do so.`})}),`\n`,_jsx(Heading,{level:`2`,id:`when-should-i-fine-tune-agent-intents`,children:`When should I fine-tune Agent intents?`}),`\n`,_jsx(_components.p,{children:`For most use cases involving general Q\u0026A, fine-tuning intents is not necessary. Our own internal tests have\nshown that AI-generated intents are typically sufficient for good Agent routing.`}),`\n`,_jsx(_components.p,{children:`Allowing bot makers to control intent classification at a granular level empowers them to enhance chatbot performance\nin situations where many AI Agents are involved, or where the chatbot requires a high degree of precision.`}),`\n`,_jsx(_components.p,{children:`When designing a multi-agent setup, we recommend keeping to a “MECE” approach.\n“MECE” refers to - Mutually Exclusive, Collectively Exhaustive. In other words, no gaps, no overlaps.`}),`\n`,_jsx(_components.p,{children:`Ideally, you want the situation where:`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`User-facing Agent A handles:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`intent class 1`}),`\n`,_jsx(_components.li,{children:`intent class 2`}),`\n`,_jsx(_components.li,{children:`intent class 3`}),`\n`,_jsx(_components.li,{children:`etc.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`User-facing Agent B handles:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`intent class 10`}),`\n`,_jsx(_components.li,{children:`intent class 11`}),`\n`,_jsx(_components.li,{children:`intent class 12`}),`\n`,_jsx(_components.li,{children:`etc.`}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`and there is `,_jsx(_components.strong,{children:`minimal`}),` overlap in intents among Agents.\nAll your Agents combined should cover all possible intents your users might have.`]}),`\n`,_jsx(_components.p,{children:`But since you can’t ever account for all intents in the universe, and given the fact that intents are\npresented in natural language which can have multiple permutations to express the same meaning,\nthere is no deterministic way to get 100% consistency. But you can get pretty close with an\noptimized setup.`}),`\n`,_jsx(_components.p,{children:`During your chatbot’s operations, it is important to monitor incoming conversations and identify instances\nwhere the wrong Agent was chosen to handle a user’s query. In these situations, we recommend that you make\nuse of our “Debug mode”. In this mode, if you have multiple user-facing Agents set up, you will see “Intent”\nand “Active Agent” show up alongside every user query that underwent Agent routing.`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=5c48430ca3d35ed9d9d714a8649e5cfa`,\"data-og-width\":`657`,width:`657`,\"data-og-height\":`773`,height:`773`,\"data-path\":`images/fine-tuning-agent-intents-10.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?w=280\u0026fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=41eeede9908a63849e54ab0d59b77bcc 280w, https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?w=560\u0026fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=7da2b6782edba5f97aacfefc5d57f577 560w, https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?w=840\u0026fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=4484ce864fee82b9c164c6e3ca08c530 840w, https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?w=1100\u0026fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=acb511c989145544ce652657e33b7980 1100w, https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?w=1650\u0026fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=beb87807de04a8b615482edc27747a5e 1650w, https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/fine-tuning-agent-intents-10.png?w=2500\u0026fit=max\u0026auto=format\u0026n=_PfgpPLIz_t18KMO\u0026q=85\u0026s=7420ce5d8d4574b5069a01a139330709 2500w`})}),`\n`,_jsx(_components.p,{children:`If the incorrect Agent has been assigned, a quick and effective fix is to add the intent and the corresponding\nuser query to what should have been the correct Agent to handle the request within AI Supervisor Settings -> Intents.\nThis will ensure that if queries of the same type were to come up again, the correct Agent would be chosen.\nProviding more examples for this intent will further reinforce the ability for the AI Supervisor to classify\nsimilar cases in the future.`})]})}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":"Fine Tuning Agent Intents","description":null,"href":"/fine-tuning-agent-intents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"When should I fine-tune Agent intents?","slug":"when-should-i-fine-tune-agent-intents","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"chatsistant","siteName":"Chatsistant API","title":"Fine Tuning Agent Intents - Chatsistant API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T05:56:55.417Z","originalFileLocation":"fine-tuning-agent-intents.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=\"Fine Tuning Agent Intents - 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/fine-tuning-agent-intents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://chatsistant.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Fine+Tuning+Agent+Intents\u0026amp;theme=d7f2b54eec0e3933ad58bfa6\u0026amp;signature=dc1b12643c06dbb6217b2edc64afb5aef28d386ca4de7009d6f95947f70dca41\">\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=\"Fine Tuning Agent Intents - Chatsistant API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://chatsistant.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Fine+Tuning+Agent+Intents\u0026amp;theme=d7f2b54eec0e3933ad58bfa6\u0026amp;signature=dc1b12643c06dbb6217b2edc64afb5aef28d386ca4de7009d6f95947f70dca41\">\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/fine-tuning-agent-intents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fine-tuning-agent-intents.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/bw0W4PPFP0FNqFg-/logo/light.svg?fit=max\u0026auto=format\u0026n=bw0W4PPFP0FNqFg-\u0026q=85\u0026s=f721e4cc50453f170fe167c8d5f9971f\"}},{\"@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/fine-tuning-agent-intents#webpage\",\"url\":\"https://docs.chatsistant.com/fine-tuning-agent-intents\",\"name\":\"Fine Tuning Agent Intents\",\"dateModified\":\"2026-01-07T05:56:55.417Z\",\"isPartOf\":{\"@id\":\"https://docs.chatsistant.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.chatsistant.com/fine-tuning-agent-intents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.chatsistant.com/fine-tuning-agent-intents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.chatsistant.com/creating-first-chatbot\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fine Tuning Agent Intents\",\"item\":\"https://docs.chatsistant.com/fine-tuning-agent-intents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.chatsistant.com/fine-tuning-agent-intents#article\",\"headline\":\"Fine Tuning Agent Intents\",\"name\":\"Fine Tuning Agent Intents\",\"url\":\"https://docs.chatsistant.com/fine-tuning-agent-intents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.chatsistant.com/fine-tuning-agent-intents#webpage\"},\"dateModified\":\"2026-01-07T05:56:55.417Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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","href":"/conversation-labeling"},{"title":"Multi-Agents Chatbot","description":null,"href":"/multi-agents-chatbot"},{"title":"Fine Tuning Agent Intents","href":"/fine-tuning-agent-intents"},{"title":"AI Supervisor Overrides","description":null,"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"}]}]},{"anchor":"API References","icon":"code","pages":[{"title":"API References","href":"/api-reference/api-key-setup"}]}]},"basePath":"","title":"Fine Tuning Agent Intents - Chatsistant API","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BdiBGm0H.js","DynamicMarkdown-CbqEDjbV.js","zoom-image-lightbox-CvtNkYOX.js","lightbox-handle-r17bVUz3.js"]}