The Core Agent is general-purpose and is the main way to work on AI Suite. An Assistant is an optional custom agent tuned for one recurring job. You give it a name, instructions, a model, and โ if you like โ tools and documents. Then you pick it in the Agents tab.If youโve read Build an app, this will feel familiar. An Assistant is like an app that can also use tools and take action.
Go to Agents (or the Platform area) and choose Create โ Assistant.
Starting a new Assistant.
2
Name it
Give it a clear name, like โTravel Plannerโ or โSupport Helperโ.
3
Write its instructions
Tell it who it is and how to behave, in plain words:
You are a friendly travel planner. Ask the user for their destination, dates, and budget. Then suggest a simple day-by-day plan. Keep it short and cheerful.
Good instructions = clear job + clear tone + any rules. Imagine training a new assistant on day one.
Writing the Assistant's name and instructions.
4
Choose a model
Pick the AI brain โ see Choosing a model. Default is fine to start.
5
Add tools (optional)
Turn on any tools it should use (like a connected calendar or search). See Connect your tools.
6
Add knowledge (optional)
Upload documents so it answers from your own information โ see Ask your own documents.
7
Test it
Use the built-in preview to chat with your Assistant. Try a real question and see how it responds.
Testing the new Assistant in its preview chat.
8
Save and use it
Save it. Now open the Agents tab, pick your Assistant from the agent picker, and put it to work โ or share it with your team.
Most people should stay with the Core Agent for everyday work (docs, sheets, PDFs, multi-step tasks). Build an Assistant only when you want a named specialist with fixed instructions you reuse often.Managed agents are an advanced option โ skip them unless you specifically need more autonomous automation.
Back to the primary Agent workflow most teams use daily.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SundayPyjamas AI Suite","colors":{"primary":"#52525B","light":"#A1A1AA","dark":"#27272A"},"logo":{"light":"https://mintcdn.com/sundaypyjamas/mPtTCdYgcCjb2V3-/logo/dark.svg?fit=max\u0026auto=format\u0026n=mPtTCdYgcCjb2V3-\u0026q=85\u0026s=e5e3e1e59634cc40750fcd055681aa89","dark":"https://mintcdn.com/sundaypyjamas/mPtTCdYgcCjb2V3-/logo/light.svg?fit=max\u0026auto=format\u0026n=mPtTCdYgcCjb2V3-\u0026q=85\u0026s=b9d1555ea0161f6a3430f051ece1ad65","href":"https://suite.sundaypyjamas.com"},"favicon":"https://mintcdn.com/sundaypyjamas/cBD4NursMvkHwenF/favicon.ico?fit=max\u0026auto=format\u0026n=cBD4NursMvkHwenF\u0026q=85\u0026s=5434345933ef2101b5a73c0c78e619f4","background":{"decoration":"gradient"},"navbar":{"links":[],"primary":{"type":"button","label":"Get API Key","href":"https://suite.sundaypyjamas.com"}},"footer":{"socials":{"github":"https://github.com/sundaypyjamas"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"API Platform","icon":"gauge-high","href":"https://suite.sundaypyjamas.com"},{"anchor":"GitHub","icon":"github","href":"https://github.com/sundaypyjamas"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sundaypyjamas","hasAudioNarration":false,"actualSubdomain":"sundaypyjamas","customDomains":["docs.sundaypyjamas.com"],"gitSource":{"type":"github","owner":"sundaypyjamas","repo":"ai-suite-platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a627a388723c3305aa0c570","collectionId":"9ce5307a-a942-4dbf-826f-0f7ce643a836","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a627a388723c3305aa0c570"},"entitlements":{},"buildId":"6a627a388723c3305aa0c570:success","clientVersion":"0.0.3939","searchFilterCounts":[{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"User Guide","count":26},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Work with Agents","count":6},{"language":"default","tag":"Manage \u0026 Get Help","count":6},{"language":"default","tag":"Agents","count":5},{"language":"default","tag":"More Ways to Work","count":5},{"language":"default","tag":"Useful Skills","count":5},{"language":"default","tag":"Apps","count":4},{"language":"default","tag":"Storage","count":4}]},"assistantConfig":{},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navbar{z-index:30}.dark #navbar,.dark #navbar-transition{background-color:#0a0a0a!important;opacity:1!important}html:not(.dark) #navbar,html:not(.dark) #navbar-transition{background-color:#fff!important;opacity:1!important}#sidebar-content .pointer-events-none.sticky{display:none!important}#navigation-items{padding-top:.5rem}"}],"page":{"pagePath":"user-guide/assistants","slug":"/user-guide/assistants","pageMetadata":{"title":"Build an Assistant","description":"Optional: create a custom specialist agent. Most people can stay with the Core Agent.","href":"/user-guide/assistants"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Optional: create a custom specialist agent. Most people can stay with the Core Agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,em:`em`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,Frame,Heading,Note,OptimizedImage,Step,Steps,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`what-is-an-assistant`,children:`What is an Assistant?`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`/user-guide/agents/what-are-agents`,children:`Core Agent`}),` is general-purpose and is the `,_jsx(_components.strong,{children:`main`}),` way to work on AI Suite. An `,_jsx(_components.strong,{children:`Assistant`}),` is an optional `,_jsx(_components.strong,{children:`custom agent`}),` tuned for one recurring job. You give it a name, instructions, a model, and โ if you like โ tools and documents. Then you pick it in the `,_jsx(_components.a,{href:`/user-guide/agents/using-the-agents-tab`,children:`Agents tab`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If youโve read `,_jsx(_components.a,{href:`/user-guide/build-an-app`,children:`Build an app`}),`, this will feel familiar. An Assistant is like an app that can also `,_jsx(_components.strong,{children:`use tools`}),` and `,_jsx(_components.strong,{children:`take action`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`New here? Learn `,_jsx(_components.a,{href:`/user-guide/first-agent`,children:`chat with the Core Agent`}),` and `,_jsx(_components.a,{href:`/user-guide/agents/create-files`,children:`create files`}),` first. Come back to Assistants when you need a reusable specialist.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`build-it-step-by-step`,children:`Build it step by step`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Start a new Assistant`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Agents`}),` (or the Platform area) and choose `,_jsx(_components.strong,{children:`Create`}),` โ `,_jsx(_components.strong,{children:`Assistant`}),`.`]}),_jsx(Frame,{caption:`Starting a new Assistant.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=4810d3e14f797788f6b464f22bc4f267`,alt:`The create-assistant screen`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/user-guide/agents-create-assistant-start.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?w=280\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=5b9c442a529645f2f64c93ccf407321c 280w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?w=560\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=257e11db99e0c4dc2d55db5fbbe434ad 560w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?w=840\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=e1790574d65fafe9942a230c96d82773 840w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?w=1100\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=f686b6b04251116c26348d2c9e9be036 1100w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?w=1650\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=0acc2f230de66749a705e18cfa8020a7 1650w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-start.png?w=2500\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=c545e83d4e0d0c23d48736310ad237b7 2500w`})})]}),_jsx(Step,{title:`Name it`,children:_jsxs(_components.p,{children:[`Give it a clear name, like `,_jsx(_components.em,{children:`โTravel Plannerโ`}),` or `,_jsx(_components.em,{children:`โSupport Helperโ`}),`.`]})}),_jsxs(Step,{title:`Write its instructions`,children:[_jsx(_components.p,{children:`Tell it who it is and how to behave, in plain words:`}),_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:_jsx(_components.em,{children:`You are a friendly travel planner. Ask the user for their destination, dates, and budget. Then suggest a simple day-by-day plan. Keep it short and cheerful.`})}),`\n`]}),_jsx(Tip,{children:_jsx(_components.p,{children:`Good instructions = clear job + clear tone + any rules. Imagine training a new assistant on day one.`})}),_jsx(Frame,{caption:`Writing the Assistant's name and instructions.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=87c0a7ad838fc156029881fdbf5267d4`,alt:`Form for the assistant name and instruction text`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/user-guide/agents-create-assistant-instructions.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?w=280\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=cb67019781f4d03b38a46aea82d6a836 280w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?w=560\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=551bf53db7b6865eb438afa6ff8469ae 560w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?w=840\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=89e9485087dfe31562142121172e1b36 840w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?w=1100\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=b4084403637d4189767e91ae78158a8e 1100w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?w=1650\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=48de47c60e45cb515dd1bb30c420c4ef 1650w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-instructions.png?w=2500\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=e58e14f4988a10f1966fc1167ce2300c 2500w`})})]}),_jsx(Step,{title:`Choose a model`,children:_jsxs(_components.p,{children:[`Pick the AI brain โ see `,_jsx(_components.a,{href:`/user-guide/choosing-models`,children:`Choosing a model`}),`. Default is fine to start.`]})}),_jsx(Step,{title:`Add tools (optional)`,children:_jsxs(_components.p,{children:[`Turn on any tools it should use (like a connected calendar or search). See `,_jsx(_components.a,{href:`/user-guide/integrations`,children:`Connect your tools`}),`.`]})}),_jsx(Step,{title:`Add knowledge (optional)`,children:_jsxs(_components.p,{children:[`Upload documents so it answers from your own information โ see `,_jsx(_components.a,{href:`/user-guide/knowledge`,children:`Ask your own documents`}),`.`]})}),_jsxs(Step,{title:`Test it`,children:[_jsx(_components.p,{children:`Use the built-in preview to chat with your Assistant. Try a real question and see how it responds.`}),_jsx(Frame,{caption:`Testing the new Assistant in its preview chat.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=7887e5bab0023256e97b08c11fa1246f`,alt:`A test chat with the new assistant`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/user-guide/agents-create-assistant-test.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?w=280\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=f13c56b864722970226afa3de4c88bc9 280w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?w=560\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=faf1baefa17d443495d83f093f89c0fb 560w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?w=840\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=512b78676df1f621f7ccf39ae41fb28d 840w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?w=1100\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=d0d89fa167e436ca8751cd6e6f642d71 1100w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?w=1650\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=ea96074ab0339a5a0889fa9b31d10e2f 1650w, https://mintcdn.com/sundaypyjamas/s9bw5Uhxs58-xnp0/images/user-guide/agents-create-assistant-test.png?w=2500\u0026fit=max\u0026auto=format\u0026n=s9bw5Uhxs58-xnp0\u0026q=85\u0026s=e31c1097f7e084a6cf8de981b1ba3a3c 2500w`})})]}),_jsx(Step,{title:`Save and use it`,children:_jsxs(_components.p,{children:[`Save it. Now open the `,_jsx(_components.a,{href:`/user-guide/agents/using-the-agents-tab`,children:`Agents tab`}),`, pick your Assistant from the agent picker, and put it to work โ or `,_jsx(_components.a,{href:`/user-guide/agents/run-and-share`,children:`share it`}),` with your team.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`making-it-better`,children:`Making it better`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`If it forgets a rule`}),`, add that rule to the instructions.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`If it needs to do something`}),`, give it the right tool.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`If it needs facts`}),`, add documents to its knowledge.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Test the hard cases`}),` โ the awkward questions it will really get.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`do-you-need-an-assistant`,children:`Do you need an Assistant?`}),`\n`,_jsxs(_components.p,{children:[`Most people should stay with the `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/user-guide/agents/what-are-agents`,children:`Core Agent`})}),` for everyday work (docs, sheets, PDFs, multi-step tasks). Build an Assistant only when you want a `,_jsx(_components.strong,{children:`named specialist`}),` with fixed instructions you reuse often.`]}),`\n`,_jsxs(_components.p,{children:[`Managed agents are an `,_jsx(_components.a,{href:`/user-guide/managed-agents`,children:`advanced option`}),` โ skip them unless you specifically need more autonomous automation.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-step`,children:`Next step`}),`\n`,_jsx(Card,{title:`Create docs, sheets \u0026 PDFs`,icon:`file-lines`,href:`/user-guide/agents/create-files`,children:_jsx(_components.p,{children:`Back to the primary Agent workflow most teams use daily.`})})]})}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":"Build an Assistant","description":"Optional: create a custom specialist agent. Most people can stay with the Core Agent.","href":"/user-guide/assistants"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What is an Assistant?","slug":"what-is-an-assistant","depth":2,"children":[]},{"title":"Build it step by step","slug":"build-it-step-by-step","depth":2,"children":[]},{"title":"Making it better","slug":"making-it-better","depth":2,"children":[]},{"title":"Do you need an Assistant?","slug":"do-you-need-an-assistant","depth":2,"children":[]},{"title":"Next step","slug":"next-step","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sundaypyjamas","siteName":"SundayPyjamas AI Suite","title":"Build an Assistant - SundayPyjamas AI Suite","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-23T20:32:10.521Z","originalFileLocation":"user-guide/assistants.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=\"description\" content=\"Optional: create a custom specialist agent. Most people can stay with the Core Agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SundayPyjamas AI Suite\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_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/sundaypyjamas/wQgQ3BV84t2A39dR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Build an Assistant - SundayPyjamas AI Suite\">\u003cmeta data-mint-head property=\"og:description\" content=\"Optional: create a custom specialist agent. Most people can stay with the Core Agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SundayPyjamas AI Suite\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sundaypyjamas.com/user-guide/assistants\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sundaypyjamas.mintlify.app/_mintlify/api/og/v2?division=More+Ways+to+Work\u0026amp;title=Build+an+Assistant\u0026amp;description=Optional%3A+create+a+custom+specialist+agent.+Most+people+can+stay+with+the+Core+Agent.\u0026amp;theme=6528323b0edbe101a47989e5\u0026amp;signature=1d6e43d85ed04ae6f257b0610a1246cd4ff3ba9966bcb16cb8ca190c55f6d676\">\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=\"Build an Assistant - SundayPyjamas AI Suite\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Optional: create a custom specialist agent. Most people can stay with the Core Agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sundaypyjamas.mintlify.app/_mintlify/api/og/v2?division=More+Ways+to+Work\u0026amp;title=Build+an+Assistant\u0026amp;description=Optional%3A+create+a+custom+specialist+agent.+Most+people+can+stay+with+the+Core+Agent.\u0026amp;theme=6528323b0edbe101a47989e5\u0026amp;signature=1d6e43d85ed04ae6f257b0610a1246cd4ff3ba9966bcb16cb8ca190c55f6d676\">\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/sundaypyjamas/wQgQ3BV84t2A39dR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SundayPyjamas AI Suite\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#52525B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sundaypyjamas.com/user-guide/assistants\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/user-guide/assistants.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sundaypyjamas.com/#organization\",\"name\":\"SundayPyjamas AI Suite\",\"url\":\"https://docs.sundaypyjamas.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sundaypyjamas/mPtTCdYgcCjb2V3-/logo/dark.svg?fit=max\u0026auto=format\u0026n=mPtTCdYgcCjb2V3-\u0026q=85\u0026s=e5e3e1e59634cc40750fcd055681aa89\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sundaypyjamas.com#website\",\"name\":\"SundayPyjamas AI Suite\",\"url\":\"https://docs.sundaypyjamas.com\",\"publisher\":{\"@id\":\"https://docs.sundaypyjamas.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sundaypyjamas.com/user-guide/assistants#webpage\",\"url\":\"https://docs.sundaypyjamas.com/user-guide/assistants\",\"name\":\"Build an Assistant\",\"description\":\"Optional: create a custom specialist agent. Most people can stay with the Core Agent.\",\"dateModified\":\"2026-07-23T20:32:10.521Z\",\"isPartOf\":{\"@id\":\"https://docs.sundaypyjamas.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sundaypyjamas.com/user-guide/assistants#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sundaypyjamas.com/user-guide/assistants#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"More Ways to Work\",\"item\":\"https://docs.sundaypyjamas.com/user-guide/first-chat\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Build an Assistant\",\"item\":\"https://docs.sundaypyjamas.com/user-guide/assistants\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sundaypyjamas.com/user-guide/assistants#article\",\"headline\":\"Build an Assistant\",\"name\":\"Build an Assistant\",\"description\":\"Optional: create a custom specialist agent. Most people can stay with the Core Agent.\",\"url\":\"https://docs.sundaypyjamas.com/user-guide/assistants\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sundaypyjamas.com/user-guide/assistants#webpage\"},\"dateModified\":\"2026-07-23T20:32:10.521Z\",\"publisher\":{\"@id\":\"https://docs.sundaypyjamas.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sundaypyjamas.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SundayPyjamas AI Suite\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SundayPyjamas AI Suite","nav":{"global":{"anchors":[{"anchor":"API Platform","icon":"gauge-high","href":"https://suite.sundaypyjamas.com"},{"anchor":"GitHub","icon":"github","href":"https://github.com/sundaypyjamas"}]},"tabs":[{"tab":"User Guide","groups":[{"group":"Start Here","pages":[{"title":"Welcome ๐","href":"/user-guide/welcome"},{"title":"Create Your Account","href":"/user-guide/create-account"},{"title":"A Tour of Your Workspace","href":"/user-guide/workspace-tour"},{"title":"Chat with Your First Agent","href":"/user-guide/first-agent"}]},{"group":"Work with Agents","pages":[{"title":"Meet the Agent","href":"/user-guide/agents/what-are-agents"},{"title":"Using the Agents Tab","href":"/user-guide/agents/using-the-agents-tab"},{"title":"What the Core Agent Can Do","href":"/user-guide/agents/capabilities"},{"title":"Create Docs, Sheets \u0026 PDFs","href":"/user-guide/agents/create-files"},{"title":"Configure the Core Agent","href":"/user-guide/agents/configure"},{"title":"Run \u0026 Share an Agent","href":"/user-guide/agents/run-and-share"}]},{"group":"Useful Skills","pages":[{"title":"Writing Good Prompts","href":"/user-guide/writing-prompts"},{"title":"Choosing a Model","href":"/user-guide/choosing-models"},{"title":"Ask Your Own Documents","href":"/user-guide/knowledge"},{"title":"Make Images","href":"/user-guide/images"},{"title":"Create a Report","href":"/user-guide/reports"}]},{"group":"More Ways to Work","pages":[{"title":"Plain Chat (Optional)","description":"Quick Q\u0026A without files or tools โ handy, but secondary to Agents on the AI Suite platform.","href":"/user-guide/first-chat"},{"title":"Build an Assistant","href":"/user-guide/assistants"},{"title":"Build Your Own AI App","description":"Optional: create a reusable AI helper. Most everyday work belongs in Agents.","href":"/user-guide/build-an-app"},{"title":"Connect Your Tools","href":"/user-guide/integrations"},{"title":"Share Your Work","href":"/user-guide/sharing"}]},{"group":"Manage \u0026 Get Help","pages":[{"title":"Team \u0026 Billing","href":"/user-guide/team-and-billing"},{"title":"Real-World Scenarios","href":"/user-guide/scenarios"},{"title":"FAQ \u0026 Troubleshooting","href":"/user-guide/faq"},{"title":"Plain-Language Glossary","href":"/user-guide/glossary"},{"title":"For Developers","href":"/user-guide/for-developers"},{"title":"Managed Agents (Advanced)","href":"/user-guide/managed-agents"}]}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/chat/introduction"}]}]},"title":"Build an Assistant - SundayPyjamas AI Suite","buildId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","deploymentId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CUTvSGqu.js","DynamicMarkdown-BGu84FgU.js","zoom-image-lightbox-ChyC7Hte.js","PlusIcon-DXkY3IBj.js","lightbox-handle-r17bVUz3.js"]}