Custom agents can be created only via the UI. Visit you.com/agents and create a new custom agent with your personalized parameters:Choose whether to enable the tools or not:
WARNING: The Custom Agent API currently does not support custom agents that use a foundational model with advanced research and reasoning enabled.
NOTE: You can manage the tools only in the UI by enabling or disabling them. They can not be managed via the API.See Web Search Tool, Research Tool, and Compute Tool to learn more about tools.
When you create new agents, the platform automatically populates the Agents section with all of the agents you’ve created. This is where you can retrieve each agent’s ID:Paste the ID in the agent parameter to call it via API.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"You.com API","colors":{"primary":"#596CED","light":"#decef4","dark":"#596CED"},"logo":{"light":"https://mintcdn.com/you/gx9H8EPolrUtPSge/logo/light.svg?fit=max\u0026auto=format\u0026n=gx9H8EPolrUtPSge\u0026q=85\u0026s=e137388d4ab9a92522ac345398106fd6","dark":"https://mintcdn.com/you/gx9H8EPolrUtPSge/logo/dark.svg?fit=max\u0026auto=format\u0026n=gx9H8EPolrUtPSge\u0026q=85\u0026s=85ee41f940bc8d99aad0168c2d148d30"},"favicon":"/favicon.png","api":{"openapi":["openapi.yaml","openapi_chat.yaml"]},"background":{"decoration":"gradient","color":{"dark":"#090014"}},"navbar":{"links":[{"label":"Discord","href":"https://discord.com/invite/youdotcom"}],"primary":{"type":"button","label":"Get an API Key","href":"https://you.com/platform"}},"footer":{"socials":{"twitter":"https://twitter.com/youdotcom","linkedin":"https://www.linkedin.com/company/youdotcom"}},"icons":{"library":"lucide"},"styling":{},"integrations":{"ga4":{"measurementId":"G-D65GMT6MQN"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"you","hasAudioNarration":false,"actualSubdomain":"you","customDomains":["old-docs.you.com"],"gitSource":{"type":"github","owner":"su-sea","repo":"docs-example","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21c926539692d19e12cd4d","collectionId":"f58c71bd-37ef-4564-984d-fe4050e9be9a","schemaVersion":"v2"},"entitlements":{},"buildId":"6a21c926539692d19e12cd4d:success","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":20},{"language":"default","tag":"Developer Resources","count":9},{"language":"default","tag":"Tutorials","count":8},{"language":"default","tag":"Get Started","count":4},{"language":"default","tag":"Tools","count":4},{"language":"default","tag":"Agent","count":3},{"language":"default","tag":"Custom Agent","count":3},{"language":"default","tag":"Other Tools","count":3},{"language":"default","tag":"Advanced Agent","count":2},{"language":"default","tag":"Search","count":2}]},"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":"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".text-light{margin-top:2rem;margin-bottom:4%;font-size:2rem;font-weight:600;font-family:Arial,Helvetica,sans-serif;color:#000}.dark\\:text-dark:is(.dark *){color:#fff}"},{"filePath":"styles/custom.css","content":".custom-welcome-page>div{max-width:none!important;padding:0!important}.custom-welcome-page>div>h1:first-child{display:none}.custom-welcome-page #welcome{display:flex;flex-direction:column;justify-content:flex-start;align-items:center;width:100%;max-width:1200px;margin:0 auto;min-height:auto;padding:2rem .5rem}.text-light{margin-top:2rem;margin-bottom:4%;font-size:2rem;font-weight:600;font-family:Arial,Helvetica,sans-serif;color:#000}.dark\\:text-dark:is(.dark *){color:#fff}.card-container{display:grid;grid-template-columns:repeat(auto-fit,minmax(250px,1fr));gap:20px}.prose pre{background:0 0;box-shadow:none}.dark .prose pre{background:#0b1220;border:1px solid rgba(255,255,255,.08)}.beta-badge{display:inline-block;padding:2px 8px;margin:8px 0 12px;font-size:12px;font-weight:600;letter-spacing:.02em;color:#1e3a8a;background:#dbeafe;border:1px solid #93c5fd;border-radius:9999px}.dark .beta-badge{color:#bfdbfe;background:rgba(30,58,138,.35);border-color:#60a5fa}.prose h1{display:inline-block;margin-right:8px}.prose h1+.beta-badge{display:inline-block;vertical-align:middle;position:relative;top:-2px}#custom-agents-page:before{content:\"\"}.prose h1:has(+#custom-agents-page){display:inline-block;margin-right:8px}.prose h1:has(+#custom-agents-page)::after{content:\"Beta\";display:inline-block;padding:2px 8px;margin-left:8px;font-size:12px;font-weight:600;letter-spacing:.02em;color:#1e3a8a;background:#dbeafe;border:1px solid #93c5fd;border-radius:9999px}.dark .prose h1:has(+#custom-agents-page)::after{color:#bfdbfe;background:rgba(30,58,138,.35);border-color:#60a5fa}"}],"page":{"pagePath":"developer-resources/tutorials/custom-agent/create-custom-agents","slug":"/developer-resources/tutorials/custom-agent/create-custom-agents","pageMetadata":{"title":"Create Custom Agents","description":"Learn how to create custom agents","href":"/developer-resources/tutorials/custom-agent/create-custom-agents"},"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: \"Learn how to create custom agents\"\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`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note,OptimizedImage,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Custom agents can be created only via the UI. Visit `,_jsx(_components.a,{href:`https://you.com/agent`,children:`you.com/agents`}),` and create a new custom agent with your personalized parameters:`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=8e19ba8c0d38151ad1141c1ae1b54ef4`,alt:`New agent settings for custom agents in you.com`,\"data-og-width\":`1229`,width:`1229`,\"data-og-height\":`808`,height:`808`,\"data-path\":`images/custom-agents/agent-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=156bd89a3a28f29b98216fb6390aa115 280w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=7812cb9f2556dc0aa37f7f62aa0738bf 560w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=f8500a5e43218556e43a254a6fb741c5 840w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=8639c5442fdaf9e9488427a969b2e620 1100w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=2fe45ab05328c151e924920669d48bde 1650w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/agent-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=be5c422f5f84c77c3dbb9fd50fade9ad 2500w`}),`\n`,_jsx(_components.p,{children:`Choose whether to enable the tools or not:`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=237364ff819c67d07855b56a9ce62d40`,alt:`New agent settings for custom agents in you.com`,\"data-og-width\":`1230`,width:`1230`,\"data-og-height\":`804`,height:`804`,\"data-path\":`images/custom-agents/manage-tools-activation.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?w=280\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=c4191b8e3f32a6c4b7376220e49445c0 280w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?w=560\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=79e1eefecbf2866a0e16e45d2800fd9c 560w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?w=840\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=7229d2af96299ab3b85fcc8326efecd3 840w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?w=1100\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=746759e9a6c8c14d71e6aa5b78a854a7 1100w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?w=1650\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=29beab5373fc502794bcb7a869fd04ad 1650w, https://mintcdn.com/you/dp1NpOeBU78jH4hQ/images/custom-agents/manage-tools-activation.png?w=2500\u0026fit=max\u0026auto=format\u0026n=dp1NpOeBU78jH4hQ\u0026q=85\u0026s=2815e32d39de7ca1d101cbf5c509e678 2500w`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`WARNING`}),`: The `,_jsx(_components.a,{href:`/api-reference/custom-agent`,children:`Custom Agent API`}),` currently does not support custom agents that use a foundational model with advanced research and reasoning enabled.`]})}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`NOTE`}),`: You can manage the tools only in the UI by enabling or disabling them. They can not be managed via the API.`]}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/tools/web-search-tool`,children:`Web Search Tool`}),`, `,_jsx(_components.a,{href:`/tools/research-tool`,children:`Research Tool`}),`, and `,_jsx(_components.a,{href:`/tools/compute-tool`,children:`Compute Tool`}),` to learn more about tools.`]})]}),`\n`,_jsxs(_components.p,{children:[`When you create new agents, the platform automatically populates the `,_jsx(_components.strong,{children:`Agents`}),` section with all of the agents you’ve created. This is where you can retrieve each agent’s ID:`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=10bdb794e3a79ad44959e53d70ebedbc`,alt:`The agent's ID in custom agent in you.com`,\"data-og-width\":`1512`,width:`1512`,\"data-og-height\":`982`,height:`982`,\"data-path\":`images/custom-agents/agents-id.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?w=280\u0026fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=f4e0bfba0c0e0a2c685af2ddcb602bd4 280w, https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?w=560\u0026fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=14187ea7ad8d6815b813d4923b1520c9 560w, https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?w=840\u0026fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=17aa5d8abe914ace68ddbc31ca3c5d87 840w, https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=b19b68d6c2ca68fbf938f5472dd210f4 1100w, https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=bec45ffe9e78908ea2e602619d6bf503 1650w, https://mintcdn.com/you/Fr2m_JPaqXisfVRD/images/custom-agents/agents-id.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Fr2m_JPaqXisfVRD\u0026q=85\u0026s=5037472291c97bc7f4486040322ce171 2500w`}),`\n`,_jsxs(_components.p,{children:[`Paste the ID in the `,_jsx(_components.code,{children:`agent`}),` parameter `,_jsx(_components.a,{href:`/api-reference/custom-agent#body-agent`,children:`to call it via API`}),`.`]})]})}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":"Create Custom Agents","description":"Learn how to create custom agents","href":"/developer-resources/tutorials/custom-agent/create-custom-agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"you","siteName":"You.com API","title":"Create Custom Agents - You.com API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"developer-resources/tutorials/custom-agent/create-custom-agents.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=\"Learn how to create custom agents\">\u003cmeta data-mint-head name=\"application-name\" content=\"You.com 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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_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/you/faYhI-oxxSDbXhz9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Custom Agents - You.com API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Learn how to create custom agents\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"You.com API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://you.mintlify.app/_mintlify/api/og/v2?division=Custom+Agent\u0026amp;title=Create+Custom+Agents\u0026amp;description=Learn+how+to+create+custom+agents\u0026amp;theme=f554274653090c6133fad80f\u0026amp;signature=c3a2d54bf58341885346a32805bbef2bf4ededb822b645ad20da791be954e3a1\">\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=\"Create Custom Agents - You.com API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Learn how to create custom agents\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://you.mintlify.app/_mintlify/api/og/v2?division=Custom+Agent\u0026amp;title=Create+Custom+Agents\u0026amp;description=Learn+how+to+create+custom+agents\u0026amp;theme=f554274653090c6133fad80f\u0026amp;signature=c3a2d54bf58341885346a32805bbef2bf4ededb822b645ad20da791be954e3a1\">\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/you/faYhI-oxxSDbXhz9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"You.com API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#596CED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developer-resources/tutorials/custom-agent/create-custom-agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://old-docs.you.com/#organization\",\"name\":\"You.com API\",\"url\":\"https://old-docs.you.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/you/gx9H8EPolrUtPSge/logo/light.svg?fit=max\u0026auto=format\u0026n=gx9H8EPolrUtPSge\u0026q=85\u0026s=e137388d4ab9a92522ac345398106fd6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://old-docs.you.com#website\",\"name\":\"You.com API\",\"url\":\"https://old-docs.you.com\",\"publisher\":{\"@id\":\"https://old-docs.you.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents#webpage\",\"url\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents\",\"name\":\"Create Custom Agents\",\"description\":\"Learn how to create custom agents\",\"isPartOf\":{\"@id\":\"https://old-docs.you.com#website\"},\"breadcrumb\":{\"@id\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tutorials\",\"item\":\"https://old-docs.you.com/developer-resources/tutorials/search/guides\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Custom Agents\",\"item\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents#article\",\"headline\":\"Create Custom Agents\",\"name\":\"Create Custom Agents\",\"description\":\"Learn how to create custom agents\",\"url\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents\",\"mainEntityOfPage\":{\"@id\":\"https://old-docs.you.com/developer-resources/tutorials/custom-agent/create-custom-agents#webpage\"},\"publisher\":{\"@id\":\"https://old-docs.you.com/#organization\"},\"isPartOf\":{\"@id\":\"https://old-docs.you.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"You.com API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"You.com API","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/get-started/welcome"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/search"}]},{"tab":"Tools","pages":[{"title":"Tools","href":"/tools/mcp-server"}]},{"tab":"Developer Resources","groups":[{"group":"Tutorials","pages":[{"group":"Search","pages":[{"title":"Guides","href":"/developer-resources/tutorials/search/guides"},{"title":"Search Operators","href":"/developer-resources/tutorials/search/search-operators"}]},{"group":"Advanced Agent","pages":[{"title":"Stream Response in cURL","href":"/developer-resources/tutorials/advanced-agent/curl-stream-response"},{"title":"Stream Response in Python","description":"Learn how to manage the stream response with the Advanced Agent API in Python","href":"/developer-resources/tutorials/advanced-agent/python-stream-response"}]},{"group":"Custom Agent","pages":[{"title":"Create Custom Agents","href":"/developer-resources/tutorials/custom-agent/create-custom-agents"},{"title":"Use Custom Agents Via Chat","description":"Learn how to use custom agents via the UI","href":"/developer-resources/tutorials/custom-agent/use-custom-agents-chat"},{"title":"Stream Response in cURL","href":"/developer-resources/tutorials/custom-agent/curl-stream-response"}]},{"group":"Express Agent","pages":[{"title":"Stream Response in cURL","href":"/developer-resources/tutorials/express-agent/curl-stream-response"}]}]},{"group":"Errors","pages":[{"title":"Errors","href":"/developer-resources/errors"}]}]}]},"title":"Create Custom Agents - You.com API","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-BNnMwe0F.js","lightbox-handle-r17bVUz3.js"]}