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-trainer API","colors":{"primary":"#2E3F51","light":"#516F90","dark":"#0D001D"},"favicon":"https://mintcdn.com/paladinmaxinc/_odr0HDBZYr--Le1/logo/favicon.png?fit=max\u0026auto=format\u0026n=_odr0HDBZYr--Le1\u0026q=85\u0026s=d04dff53c81245c4d48f0301bad6209f","logo":{"light":"https://mintcdn.com/paladinmaxinc/_odr0HDBZYr--Le1/logo/light.svg?fit=max\u0026auto=format\u0026n=_odr0HDBZYr--Le1\u0026q=85\u0026s=e282ced1ff19648529968cefe4eb3deb","dark":"https://mintcdn.com/paladinmaxinc/_odr0HDBZYr--Le1/logo/dark.svg?fit=max\u0026auto=format\u0026n=_odr0HDBZYr--Le1\u0026q=85\u0026s=bee6ec229dfdcd8e2a9654329a38a3c6"},"api":{"mdx":{"server":"https://app.gpt-trainer.com/api","auth":{"method":"bearer","name":null}}},"background":{"decoration":null,"color":{"light":null,"dark":"#111827"}},"navbar":{"links":[{"label":"Support","href":"mailto:hello@gpt-trainer.com"}],"primary":null},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paladinmaxinc","hasAudioNarration":false,"actualSubdomain":"paladinmaxinc","customDomains":["guide.gpt-trainer.com"],"gitSource":{"type":"github","owner":"ks-collab","repo":"gpt-trainer-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e61733a4518725aab1a4","collectionId":"176b19f7-2d23-4aaa-b976-d711aa6932e6","schemaVersion":"v2"},"entitlements":{},"buildId":"6ae91e981deeea3b72f9ff99:success","clientVersion":"0.0.4054","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":"Whitelabel","count":6},{"language":"default","tag":"Agents","count":5},{"language":"default","tag":"Chatbot Sessions","count":5},{"language":"default","tag":"Integrations","count":5}]},"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},{"name":"rbac-expansion","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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=2add473cf2fabcec2c140a26f9c32e84`,\"data-og-width\":`921`,width:`921`,\"data-og-height\":`864`,height:`864`,\"data-path\":`images/fine-tuning-agent-intents-5.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?w=280\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=082b58f3fd14c04e6c1fc323f0ba50c8 280w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?w=560\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=7a59e4498ca0e6ec083f09f477161f63 560w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?w=840\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=a8e7720b2dce3da61f35e63115b8b587 840w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=274b4657a6c099aec96130588e14b431 1100w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=74774dcba4ef1e2f83cbc9c065566c0d 1650w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-5.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=4a69597b835374eb1c7912884a01f38b 2500w`})}),`\n`,_jsx(_components.p,{children:`Now head to the “Intents” tab:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=6b1ac09281e58be99c8277d487cf9fb6`,\"data-og-width\":`1122`,width:`1122`,\"data-og-height\":`654`,height:`654`,\"data-path\":`images/fine-tuning-agent-intents-6.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?w=280\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=be7852b9e5078d2b880f76e74747dc88 280w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?w=560\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=9664ff63bdcceb7cb8938ab6a4939cd7 560w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?w=840\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=fbd5ed3a9e0af4ef8becf9a186e09087 840w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=faa44064468fabf306356c83ce863e5d 1100w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=5f211a9fc32e996497f3282b73717852 1650w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-6.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=6be87ca067bbe8d2dce88d9b2c02969f 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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=070f71db200a867793f9eb75ca8419ab`,\"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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?w=280\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=4f41d6cfa28b9ae3274e79b782b51079 280w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?w=560\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=62942ed14130c5aa88890102964ee9c8 560w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?w=840\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=c7fbcbbfb8b7c118939d0089929ad3ee 840w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=66abe0b713329d6c088daf0ec55a42b9 1100w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=800aa255b3fc356705b3566cead88da5 1650w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-7.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=6cc3b54f6289c236be0cc3ca83518827 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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=e49904fed12b7f01279924319406c1ce`,\"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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?w=280\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=02f78e6dabfbb81d52085fa446a7123a 280w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?w=560\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=49969f6cb3f074dde1f72a590baa2f4c 560w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?w=840\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=507c46440fa9e14786fd13851f2503c2 840w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=97cae64481a08184bf773830bf57dca5 1100w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=b0ec8085cae4a2fd64bf9ed64ee86661 1650w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-8.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=5002f332648bb1bfaf893085dd0b0347 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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=b818215ed4fa14632cd968db575874d9`,\"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/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?w=280\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=561ccd72596f4ee0e729f27fb4e6c688 280w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?w=560\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=1799a15b053b826b07228d695010b384 560w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?w=840\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=80607375d72070104d7e3db631f33b03 840w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=90c6ad59b176520d7337af9fb7f21aa5 1100w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=856dbf4a9a0d56cfb81ad78db23acccb 1650w, https://mintcdn.com/paladinmaxinc/tQCiy4MU0bDLlaM5/images/fine-tuning-agent-intents-9.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tQCiy4MU0bDLlaM5\u0026q=85\u0026s=766cd130607cc202fea8394c70a6e296 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/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=1dc3aac41a57f38fbc278c03773cc901`,\"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/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?w=280\u0026fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=fa2bb274bc78ea31d5d8ae9662f42d55 280w, https://mintcdn.com/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?w=560\u0026fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=c8171fc8bad83ca42f61d56b2615c1af 560w, https://mintcdn.com/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?w=840\u0026fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=2fb695e6d8281ef2a4b6435ccd74cd10 840w, https://mintcdn.com/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=56abc35800136206f205fe5aab214c16 1100w, https://mintcdn.com/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=6ef42fe5e858ca225ed978751bfce8f2 1650w, https://mintcdn.com/paladinmaxinc/eQPaNa5Mj6mg9P8v/images/fine-tuning-agent-intents-10.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eQPaNa5Mj6mg9P8v\u0026q=85\u0026s=4b8720cafc70d2e9d7ccd770d9ba7e2a 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":"paladinmaxinc","siteName":"GPT-trainer API","title":"Fine Tuning Agent Intents - GPT-trainer API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T00:48:27.070Z","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-trainer 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/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_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/paladinmaxinc/rZh3k9QVucZqPJ9E/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fine Tuning Agent Intents - GPT-trainer API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GPT-trainer API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://guide.gpt-trainer.com/fine-tuning-agent-intents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paladinmaxinc.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Fine+Tuning+Agent+Intents\u0026amp;theme=d354e6b8b2605c4dee81eb93\u0026amp;signature=99f028f9345b2f6076cf1693edf24b940b1ba47461484614cd6da773fde2f6c7\">\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-trainer API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paladinmaxinc.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Fine+Tuning+Agent+Intents\u0026amp;theme=d354e6b8b2605c4dee81eb93\u0026amp;signature=99f028f9345b2f6076cf1693edf24b940b1ba47461484614cd6da773fde2f6c7\">\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/paladinmaxinc/rZh3k9QVucZqPJ9E/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GPT-trainer API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2E3F51\">\u003clink data-mint-head rel=\"canonical\" href=\"https://guide.gpt-trainer.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://guide.gpt-trainer.com/#organization\",\"name\":\"GPT-trainer API\",\"url\":\"https://guide.gpt-trainer.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/paladinmaxinc/_odr0HDBZYr--Le1/logo/light.svg?fit=max\u0026auto=format\u0026n=_odr0HDBZYr--Le1\u0026q=85\u0026s=e282ced1ff19648529968cefe4eb3deb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://guide.gpt-trainer.com#website\",\"name\":\"GPT-trainer API\",\"url\":\"https://guide.gpt-trainer.com\",\"publisher\":{\"@id\":\"https://guide.gpt-trainer.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents#webpage\",\"url\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents\",\"name\":\"Fine Tuning Agent Intents\",\"dateModified\":\"2026-01-07T00:48:27.070Z\",\"isPartOf\":{\"@id\":\"https://guide.gpt-trainer.com#website\"},\"breadcrumb\":{\"@id\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://guide.gpt-trainer.com/creating-first-chatbot\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fine Tuning Agent Intents\",\"item\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents#article\",\"headline\":\"Fine Tuning Agent Intents\",\"name\":\"Fine Tuning Agent Intents\",\"url\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents\",\"mainEntityOfPage\":{\"@id\":\"https://guide.gpt-trainer.com/fine-tuning-agent-intents#webpage\"},\"dateModified\":\"2026-01-07T00:48:27.070Z\",\"publisher\":{\"@id\":\"https://guide.gpt-trainer.com/#organization\"},\"isPartOf\":{\"@id\":\"https://guide.gpt-trainer.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GPT-trainer API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"GPT-trainer 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":"Integrations","icon":"network-wired","pages":[{"title":"Integrations","href":"/integrations/slack"}]},{"anchor":"Tools","icon":"gear","pages":[{"title":"Tools","href":"/tools/tools-intro"}]},{"anchor":"Whitelabel","icon":"browser","pages":[{"title":"Whitelabel","href":"/whitelabel/whitelabel-intro"}]}]},"basePath":"","title":"Fine Tuning Agent Intents - GPT-trainer API","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-PS-3COT9.js","DynamicMarkdown-BcnBltEQ.js","zoom-image-lightbox-B4-wUcHm.js","lightbox-handle-r17bVUz3.js"]}