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":"GPT Chatbot API","colors":{"primary":"#2E3F51","light":"#516F90","dark":"#0D001D"},"favicon":"https://mintcdn.com/gptchatbot/et1nlYck1QOJbxxd/logo/favicon.png?fit=max\u0026auto=format\u0026n=et1nlYck1QOJbxxd\u0026q=85\u0026s=6887bcfb8c0877734cb5c8e2ba023c6b","logo":{"light":"https://mintcdn.com/gptchatbot/RpxSGx9HJ26aMoIb/logo/light.svg?fit=max\u0026auto=format\u0026n=RpxSGx9HJ26aMoIb\u0026q=85\u0026s=7a58afc2a4b648ed6b3344690bbc012d","dark":"https://mintcdn.com/gptchatbot/et1nlYck1QOJbxxd/logo/dark.svg?fit=max\u0026auto=format\u0026n=et1nlYck1QOJbxxd\u0026q=85\u0026s=18c489c900d7070d713b4e7232227076"},"api":{"mdx":{"server":"https://app.gptchatbot.it/api","auth":{"method":"bearer","name":null}}},"background":{"decoration":null,"color":{"light":null,"dark":"#111827"}},"navbar":{"links":[{"label":"Support","href":"mailto:info@gptchatbot.it"}],"primary":null},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gptchatbot","hasAudioNarration":false,"actualSubdomain":"gptchatbot","customDomains":["docs.gptchatbot.it"],"gitSource":{"type":"github","owner":"federicodecillia","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a48af477c1f63e9b6f5a207","collectionId":"1d2bddc6-a57f-459a-bc5c-e13adf6914a7","schemaVersion":"v3"},"entitlements":{},"buildId":"6a48b0974fc0d1ab7935e1d6:success","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API References","count":39},{"language":"default","tag":"Documentation","count":15},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Data Sources","count":9},{"language":"default","tag":"Chatbots","count":6},{"language":"default","tag":"Session Messages","count":6},{"language":"default","tag":"Agents","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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"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/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=105d58b927528339089c21fcd5a8dcfb`,\"data-og-width\":`1474`,width:`1474`,\"data-og-height\":`1020`,height:`1020`,\"data-path\":`images/fine-tuning-agent-intents-5.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?w=280\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=7bcd413976b91ce8359cc19f9bb13873 280w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?w=560\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=5e42473d7f1ec20fc3835b165412c2a1 560w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?w=840\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=13d26d4be0203de83ea2f32651a80090 840w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=92cd5caf43403e217a9599e3d6fdbc52 1100w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=71738ab25aa0ee1e6642ef56b8c89bf6 1650w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-5.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=d78ee9c1fe461d5e13063cecf46ee78d 2500w`})}),`\n`,_jsx(_components.p,{children:`Now head to the “Intents” tab:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=ad43b535a55e9a5a037760de03e0d7aa`,\"data-og-width\":`1982`,width:`1982`,\"data-og-height\":`1114`,height:`1114`,\"data-path\":`images/fine-tuning-agent-intents-6.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?w=280\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=91f4089c6a7d94557c18dba41b3af588 280w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?w=560\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=8faf9546fdcc5b067f1ede2813748152 560w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?w=840\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=8b74fdff19abd28cae36c84b3be35cf5 840w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=af518bc5834e9d06e77b0403cfc63d4c 1100w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=d6e32e6397e1a0ea852b2104af35fc5a 1650w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-6.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=c675f6ae0eb498751d2f3166a7d250a8 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/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=2c384247a7180a6c70573a28773bd29b`,\"data-og-width\":`783`,width:`783`,\"data-og-height\":`451`,height:`451`,\"data-path\":`images/fine-tuning-agent-intents-7.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?w=280\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=f4e9a07906709a1de57052700bb58a05 280w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?w=560\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=7432a19ee7ca46371f23d8024c731b9c 560w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?w=840\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=14ebcbb0da111cdf21c5962df00a32b2 840w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=9f321be1c73df0aa942a7ff3efa9ae5d 1100w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=7fd5612380fd57da83ac22b78c42fb16 1650w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-7.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=d1bbbeb04ccaa19798ca79f6ca600167 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/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=f6187736345220a39584a008e7afe51f`,\"data-og-width\":`580`,width:`580`,\"data-og-height\":`596`,height:`596`,\"data-path\":`images/fine-tuning-agent-intents-8.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?w=280\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=2335ff93cef9eeb16e027cf08cbcc524 280w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?w=560\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=2b70b3b8275385d326112785dbba996b 560w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?w=840\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=1273bfdb8fc0af0308360232842ed511 840w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=3c276ba7dcfd01046ccfcbca267f2826 1100w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=39a83a0d10cbacb9f16c5a212e6776ad 1650w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-8.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=11cfdbe912dd172b1a9c0f3a4458f485 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/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=48da6d1d8178ce67bde7051cdb4cfafb`,\"data-og-width\":`584`,width:`584`,\"data-og-height\":`595`,height:`595`,\"data-path\":`images/fine-tuning-agent-intents-9.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?w=280\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=e6cc5f7fea57933e512fcae59292b2b7 280w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?w=560\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=9320b2692c34f85215034a56c8788a17 560w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?w=840\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=47db6e58daec8ef40238494d4d7ffcdc 840w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=91cd8e545bbe35751abeb2cb72f2f5f0 1100w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=4763f7cc1f05423e41e9d0b6d8c5523f 1650w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-9.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=6b474518421c46067de52da82f277a20 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/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=f38af097d64eebc64c5d4da07f783114`,\"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/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?w=280\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=14ca426a9542eb00d86d21e10d827073 280w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?w=560\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=52fcf2acfe2f3a9fb1d6e30b2fc0b193 560w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?w=840\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=156011f434a2c4cc852f1f76a96b2d54 840w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?w=1100\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=05965d314b087be9bd0550f366b3368f 1100w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?w=1650\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=c4b8332096fcc4ad0a6c65d77d566edc 1650w, https://mintcdn.com/gptchatbot/i05P6ienN4sNHppQ/images/fine-tuning-agent-intents-10.png?w=2500\u0026fit=max\u0026auto=format\u0026n=i05P6ienN4sNHppQ\u0026q=85\u0026s=8f8486efee2e89eda09ed3df007b72c6 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":"gptchatbot","siteName":"GPT Chatbot API","title":"Fine Tuning Agent Intents - GPT Chatbot API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-04T06:59:33.104Z","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=\"GPT Chatbot 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/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_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/gptchatbot/IDKThlX0BZP96Vwt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fine Tuning Agent Intents - GPT Chatbot API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GPT Chatbot API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gptchatbot.it/fine-tuning-agent-intents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gptchatbot.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Fine+Tuning+Agent+Intents\u0026amp;theme=20e021f1004a9f9f06bad9ba\u0026amp;signature=052c0d81c0dc53cc76c889f59c4abd8b11aea932ab383c95616e9f230d84be5b\">\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 - GPT Chatbot API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gptchatbot.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Fine+Tuning+Agent+Intents\u0026amp;theme=20e021f1004a9f9f06bad9ba\u0026amp;signature=052c0d81c0dc53cc76c889f59c4abd8b11aea932ab383c95616e9f230d84be5b\">\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/gptchatbot/IDKThlX0BZP96Vwt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GPT Chatbot API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2E3F51\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gptchatbot.it/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.gptchatbot.it/#organization\",\"name\":\"GPT Chatbot API\",\"url\":\"https://docs.gptchatbot.it\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gptchatbot/RpxSGx9HJ26aMoIb/logo/light.svg?fit=max\u0026auto=format\u0026n=RpxSGx9HJ26aMoIb\u0026q=85\u0026s=7a58afc2a4b648ed6b3344690bbc012d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gptchatbot.it#website\",\"name\":\"GPT Chatbot API\",\"url\":\"https://docs.gptchatbot.it\",\"publisher\":{\"@id\":\"https://docs.gptchatbot.it/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents#webpage\",\"url\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents\",\"name\":\"Fine Tuning Agent Intents\",\"dateModified\":\"2026-07-04T06:59:33.104Z\",\"isPartOf\":{\"@id\":\"https://docs.gptchatbot.it#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.gptchatbot.it/creating-first-chatbot\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fine Tuning Agent Intents\",\"item\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents#article\",\"headline\":\"Fine Tuning Agent Intents\",\"name\":\"Fine Tuning Agent Intents\",\"url\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gptchatbot.it/fine-tuning-agent-intents#webpage\"},\"dateModified\":\"2026-07-04T06:59:33.104Z\",\"publisher\":{\"@id\":\"https://docs.gptchatbot.it/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gptchatbot.it#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GPT Chatbot API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"GPT Chatbot 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":"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"}]},{"anchor":"Tools","icon":"gear","pages":[{"title":"Tools","href":"/tools/tools-intro"}]}]},"basePath":"","title":"Fine Tuning Agent Intents - GPT Chatbot API","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js"]}