An agent is a database record. At startup — and whenever an agent changes — the server
generates a Python module for it under agents_pool/, which Google ADK then executes.
POST /api/agents{ "agent_name": "My Assistant", "agent_model": "anthropic/claude-sonnet-4-5-20250929", "agent_description": "Specialized agent for data analysis", "agent_instruction": "You are an expert data analyst.", "agent_type": "llm", "agent_tools": ["tool_config_id_1", "tool_config_id_2"], "sub_agents": [], "memory_enabled": false, "artifacts_enabled": false, "tags": ["analytics"]}
The agent factory: the list on the left, the canvas and the creation form on the right.
memory_enabled is off unless you turn it on. An agent that seems to lose the
thread between sessions is usually an agent whose memory was never enabled — check
this field before looking for a bug.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"apowerb by thaink2","description":"Open-source agentic framework designed and developed by thaink2 (https://thaink2.com/) — orchestration, tools, RAG, Text-to-SQL and webhooks on top of FastAPI and Google ADK.","colors":{"primary":"#0A1E72","light":"#5B7CFA","dark":"#061551"},"logo":{"light":"https://mintcdn.com/thaink2-445e19b2/G-Bg0QEpn3RacSgU/logo/apowerb-wide.png?fit=max\u0026auto=format\u0026n=G-Bg0QEpn3RacSgU\u0026q=85\u0026s=8c55ead64dbd0accc078436c4677b613","dark":"https://mintcdn.com/thaink2-445e19b2/G-Bg0QEpn3RacSgU/logo/apowerb-wide.png?fit=max\u0026auto=format\u0026n=G-Bg0QEpn3RacSgU\u0026q=85\u0026s=8c55ead64dbd0accc078436c4677b613","href":"https://github.com/apowerb/apowerb"},"favicon":"https://mintcdn.com/thaink2-445e19b2/G-Bg0QEpn3RacSgU/logo/favicon.png?fit=max\u0026auto=format\u0026n=G-Bg0QEpn3RacSgU\u0026q=85\u0026s=8067a724851c9622a9ab114c9d0e798d","navbar":{"links":[{"icon":"bug","href":"https://github.com/apowerb/apowerb/issues","label":"Issues"}],"primary":{"type":"github","href":"https://github.com/apowerb/apowerb"}},"footer":{"socials":{"github":"https://github.com/apowerb","discord":"https://discord.com/channels/1470717940075597896","website":"https://thaink2.com"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/apowerb"},{"anchor":"PyPI","icon":"python","href":"https://pypi.org/project/apowerb/"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/channels/1470717940075597896"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"thaink2-445e19b2","hasAudioNarration":false,"actualSubdomain":"thaink2-445e19b2","customDomains":["docs.apowerb.com"],"gitSource":{"type":"github","owner":"apowerb","repo":"apowerb-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ad9d24c8f23b9083221e8fa","collectionId":"5a148b9c-cb04-456e-8332-ef6a79c90b36","liveDeploymentHistoryId":"6ad9d24c8f23b9083221e8fa","schemaVersion":"v3"},"feedback":{"thumbs":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad9d24c8f23b9083221e8fa","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API reference","count":217},{"language":"default","tag":"Endpoints","count":214},{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"dashboards","count":16},{"language":"default","tag":"integrations","count":15},{"language":"default","tag":"adk","count":14},{"language":"default","tag":"Deployment","count":12},{"language":"default","tag":"Platforms","count":12},{"language":"default","tag":"Get started","count":11}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"concepts/agents","slug":"/concepts/agents","pageMetadata":{"title":"Agents","description":"How an agent is defined, stored and materialised.","href":"/concepts/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: \"How an agent is defined, stored and materialised.\"\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`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`An agent is a database record. At startup — and whenever an agent changes — the server\ngenerates a Python module for it under `,_jsx(_components.code,{children:`agents_pool/`}),`, which Google ADK then executes.`]}),`\n`,_jsx(Heading,{level:`2`,id:`creating-an-agent`,children:`Creating an agent`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`POST /api/agents`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"My Assistant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"anthropic/claude-sonnet-4-5-20250929\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Specialized agent for data analysis\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_instruction\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"You are an expert data analyst.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"llm\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent_tools\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tool_config_id_1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tool_config_id_2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sub_agents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"memory_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"artifacts_enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"analytics\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Frame,{caption:`The agent factory: the list on the left, the canvas and the creation form on the right.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=68bd82e1647cb3f2a0e1e0c6346d8260`,alt:`Agent factory with the agent list, the workflow canvas and the agent creation form`,\"data-og-width\":`1600`,width:`1600`,\"data-og-height\":`1040`,height:`1040`,\"data-path\":`images/agents.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=244d2ca6846ccd29976a22d8a793e261 280w, https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=e41c964d49d0268c9af9cbac5fab1097 560w, https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=7b0fea12bc26a8acd0ea7fa28864291b 840w, https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=77443690931ff3b0ef55d5974a85efeb 1100w, https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=c4366a51374c2905ab82c983610f24eb 1650w, https://mintcdn.com/thaink2-445e19b2/01sXtdZdZRmlIMtW/images/agents.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=01sXtdZdZRmlIMtW\u0026q=85\u0026s=2f78d69c9445b875d5dae0f1105cf843 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`fields`,children:`Fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_name`})}),_jsx(_components.td,{children:`Display name, also the ADK application name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_model`})}),_jsxs(_components.td,{children:[`LiteLLM model string, e.g. `,_jsx(_components.code,{children:`anthropic/claude-sonnet-4-5-20250929`}),`. A gateway id keeps its own provider, as in `,_jsx(_components.code,{children:`edenai/anthropic/claude-haiku-5-5`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_instruction`})}),_jsx(_components.td,{children:`System instruction`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_type`})}),_jsxs(_components.td,{children:[`Execution pattern — see `,_jsx(_components.a,{href:`/concepts/orchestration`,children:`Orchestration`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent_tools`})}),_jsxs(_components.td,{children:[`Tool `,_jsx(_components.strong,{children:`config`}),` ids, not tool names — see `,_jsx(_components.a,{href:`/concepts/tools`,children:`Tools`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sub_agents`})}),_jsx(_components.td,{children:`Child agents, for the composite patterns`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`memory_enabled`})}),_jsx(_components.td,{children:`Persist and search user memory across sessions`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`artifacts_enabled`})}),_jsx(_components.td,{children:`Allow the agent to write and execute files`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`memory_enabled`}),` is `,_jsx(_components.strong,{children:`off`}),` unless you turn it on. An agent that seems to lose the\nthread between sessions is usually an agent whose memory was never enabled — check\nthis field before looking for a bug.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents`})}),_jsx(_components.td,{children:`List the caller’s agents`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`POST`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents`})}),_jsx(_components.td,{children:`Create`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents/{agent_id}`})}),_jsx(_components.td,{children:`Details`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`PUT`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents/{agent_id}`})}),_jsx(_components.td,{children:`Update`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`DELETE`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents/{agent_id}`})}),_jsx(_components.td,{children:`Delete`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`POST`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents/{agent_id}/run`})}),_jsx(_components.td,{children:`Start a background run`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/api/agents/{agent_id}/status`})}),_jsx(_components.td,{children:`Run status`})]})]})]})]})}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":"Agents","description":"How an agent is defined, stored and materialised.","href":"/concepts/agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Creating an agent","slug":"creating-an-agent","depth":2,"children":[]},{"title":"Fields","slug":"fields","depth":2,"children":[]},{"title":"Endpoints","slug":"endpoints","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"thaink2-445e19b2","siteName":"apowerb by thaink2","title":"Agents - apowerb by thaink2","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T14:10:50.204Z","originalFileLocation":"concepts/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=\"How an agent is defined, stored and materialised.\">\u003cmeta data-mint-head name=\"application-name\" content=\"apowerb by thaink2\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agents - apowerb by thaink2\">\u003cmeta data-mint-head property=\"og:description\" content=\"How an agent is defined, stored and materialised.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"apowerb by thaink2\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apowerb.com/concepts/agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://thaink2-445e19b2.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Agents\u0026amp;description=How+an+agent+is+defined%2C+stored+and+materialised.\u0026amp;theme=045de83b015c06428e8044cd\u0026amp;signature=83f67a62ed9d1afe7968f5aad0935009494f271abbc7938cb438c0d50683f11e\">\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=\"Agents - apowerb by thaink2\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How an agent is defined, stored and materialised.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://thaink2-445e19b2.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Agents\u0026amp;description=How+an+agent+is+defined%2C+stored+and+materialised.\u0026amp;theme=045de83b015c06428e8044cd\u0026amp;signature=83f67a62ed9d1afe7968f5aad0935009494f271abbc7938cb438c0d50683f11e\">\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/thaink2-445e19b2/S8FDIqkMO24RnD5m/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"apowerb by thaink2\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A1E72\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apowerb.com/concepts/agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apowerb.com/#organization\",\"name\":\"apowerb by thaink2\",\"url\":\"https://docs.apowerb.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/thaink2-445e19b2/G-Bg0QEpn3RacSgU/logo/apowerb-wide.png?fit=max\u0026auto=format\u0026n=G-Bg0QEpn3RacSgU\u0026q=85\u0026s=8c55ead64dbd0accc078436c4677b613\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apowerb.com#website\",\"name\":\"apowerb by thaink2\",\"url\":\"https://docs.apowerb.com\",\"publisher\":{\"@id\":\"https://docs.apowerb.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apowerb.com/concepts/agents#webpage\",\"url\":\"https://docs.apowerb.com/concepts/agents\",\"name\":\"Agents\",\"description\":\"How an agent is defined, stored and materialised.\",\"dateModified\":\"2026-10-20T14:10:50.204Z\",\"isPartOf\":{\"@id\":\"https://docs.apowerb.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apowerb.com/concepts/agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apowerb.com/concepts/agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Concepts\",\"item\":\"https://docs.apowerb.com/concepts/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.apowerb.com/concepts/agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.apowerb.com/concepts/agents#article\",\"headline\":\"Agents\",\"name\":\"Agents\",\"description\":\"How an agent is defined, stored and materialised.\",\"url\":\"https://docs.apowerb.com/concepts/agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apowerb.com/concepts/agents#webpage\"},\"dateModified\":\"2026-10-20T14:10:50.204Z\",\"publisher\":{\"@id\":\"https://docs.apowerb.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apowerb.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"apowerb by thaink2\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"apowerb by thaink2","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/apowerb"},{"anchor":"PyPI","icon":"python","href":"https://pypi.org/project/apowerb/"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/channels/1470717940075597896"}]},"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","icon":"rocket","pages":[{"group":"Introduction","icon":"house","pages":[{"title":"Introduction","href":""}]},{"group":"Quickstart","icon":"bolt","pages":[{"title":"Quickstart","href":"/quickstart"}]},{"group":"Installation","icon":"download","pages":[{"title":"Installation","href":"/installation"}]},{"group":"Configuration","icon":"gear","pages":[{"title":"Configuration","href":"/configuration"},{"title":"Shared model","href":"/configuration/default-llm"},{"title":"File storage","href":"/configuration/storage"},{"title":"Microsoft","href":"/configuration/microsoft"},{"title":"Google","href":"/configuration/google"},{"title":"Orchestrator","href":"/configuration/orchestration"},{"title":"Logs and traces","href":"/configuration/observability"},{"title":"System mail","href":"/configuration/mail"}]}]},{"group":"Concepts","icon":"layers","pages":[{"group":"Architecture","icon":"network-wired","pages":[{"title":"Architecture","href":"/concepts/architecture"}]},{"group":"Editions \u0026 Extensions","icon":"box","pages":[{"title":"Editions and extensions","description":"How the open-source core stays complete on its own, and how commercial bricks plug into it.","href":"/concepts/editions"}]},{"group":"Agents","icon":"robot","pages":[{"title":"Agents","href":"/concepts/agents"},{"title":"Orchestration","description":"The five execution patterns and how sub-agents compose.","href":"/concepts/orchestration"}]},{"group":"Sessions \u0026 Runs","icon":"play","pages":[{"title":"Sessions and runs","href":"/concepts/sessions-and-runs"}]},{"group":"Tools","icon":"wrench","pages":[{"title":"Tools","href":"/concepts/tools"}]},{"group":"Artifacts","icon":"box-archive","pages":[{"title":"Artifacts","href":"/guides/artifacts"}]},{"group":"Hub","icon":"store","pages":[{"title":"Agent Hub","href":"/guides/hub"}]}]},{"group":"Business Agents","icon":"sparkles","pages":[{"group":"Business knowledge (RAG)","icon":"book-open-cover","pages":[{"title":"Business knowledge (RAG)","href":"/guides/rag"}]},{"group":"Data Analyst","icon":"database","pages":[{"title":"Text-to-SQL","href":"/guides/text-to-sql"}]},{"group":"BI \u0026 Dashboards","icon":"chart-pie","pages":[{"title":"BI and dashboards","href":"/guides/bi"}]}]},{"group":"Frontend","icon":"desktop","pages":[{"group":"JavaScript SDK","icon":"code","pages":[{"title":"JavaScript SDK","href":"/ecosystem/javascript-sdk"}]},{"group":"Web Interface","icon":"window","pages":[{"title":"apowerb-ui","href":"/ecosystem/apowerb-ui"}]}]},{"group":"Automation","icon":"webhook","pages":[{"title":"Workflows","href":"/guides/workflows"},{"title":"Webhooks","href":"/guides/webhooks"},{"title":"Orchestrator","href":"/guides/orchestrator"}]},{"group":"AgentOps","icon":"magnifying-glass-chart","pages":[{"group":"Supervision","icon":"user-shield","pages":[{"title":"Supervision","href":"/monitoring/supervision"}]},{"group":"Logs","icon":"file-lines","pages":[{"title":"Logs","href":"/monitoring/logs"}]},{"group":"Guardrails","icon":"shield-check","pages":[{"title":"Guardrails","href":"/monitoring/guardrails"}]}]},{"group":"Integrations","icon":"puzzle-piece","pages":[{"group":"Overview","icon":"info","pages":[{"title":"Integrations","href":"/guides/integrations/overview"}]},{"group":"Google","icon":"google","pages":[{"title":"Google Integration","href":"/guides/integrations/google"}]},{"group":"Microsoft","icon":"microsoft","pages":[{"title":"Microsoft Integration","href":"/guides/integrations/microsoft"}]}]},{"group":"Tools \u0026 Skills","icon":"wrench","pages":[{"group":"Tools","icon":"toolbox","pages":[{"title":"Tools","href":"/guides/tools"}]},{"group":"MCP","icon":"server","pages":[{"title":"MCP","href":"/guides/mcp"}]},{"group":"Skills","icon":"lightbulb","pages":[{"title":"Skills","href":"/guides/skills"}]}]},{"group":"Ecosystem","icon":"globe","pages":[{"group":"Overview","icon":"info","pages":[{"title":"Overview","href":"/ecosystem/overview"}]},{"group":"Core","icon":"apowerb","pages":[{"title":"apowerb","href":"/ecosystem/apowerb"}]},{"group":"Interface","icon":"window","pages":[{"title":"apowerb-ui","href":"/ecosystem/apowerb-ui"}]},{"group":"RAG","icon":"database","pages":[{"title":"th2rag","href":"/ecosystem/th2rag"}]},{"group":"Monitoring","icon":"file-lines","pages":[{"title":"th2pulse","href":"/ecosystem/th2pulse"}]},{"group":"Automation","icon":"bolt","pages":[{"title":"th2etl","href":"/ecosystem/th2etl"}]}]},{"group":"Contributing","icon":"heart","pages":[{"group":"Guide","icon":"book","pages":[{"title":"Contributing","href":"/contributing/contributing"}]},{"title":"Development setup","href":"/contributing/development"},{"title":"Release process","href":"/contributing/releases"}]}]},{"tab":"Deployment","icon":"server","pages":[{"title":"Deployment","href":"/deployment/introduction"}]},{"tab":"API reference","icon":"code","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Agents - apowerb by thaink2","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js"]}