Build and run agents programmatically with the SeekrFlow Python SDK.
An agent is an AI system that reasons through problems and executes tasks autonomously. Agents are configured by specifying models, tools, instructions, and reasoning approach—providing everything needed to accomplish tasks from simple workflows to complex, open-ended objectives.Use the SeekrFlow Python SDK to build and run agents programmatically. This section covers the core building blocks:
Create and manage agents
Configure agents, reasoning effort, and tools.
Run an agent
Use threads, messages, and runs to run your agent.
Use structured outputs
Control the format of agent responses.
Tools
Extend agent capabilities with file search, web search, code interpreter, custom tools, and more.
Last modified on June 24, 2026
⌘I
{"docsConfig":{"theme":"linden","$schema":"https://mintlify.com/docs.json","name":"Seekr Documentation","colors":{"primary":"#007774","light":"#00DAD3","dark":"#007774"},"logo":{"light":"https://mintcdn.com/seekr/xCjyiASvtfX59CGv/logo/light.svg?fit=max\u0026auto=format\u0026n=xCjyiASvtfX59CGv\u0026q=85\u0026s=5631304b029d4cfaefb138711ec30bd9","dark":"https://mintcdn.com/seekr/xCjyiASvtfX59CGv/logo/dark.svg?fit=max\u0026auto=format\u0026n=xCjyiASvtfX59CGv\u0026q=85\u0026s=5757dbcccbf86fd9503b6b579ffeabbe","href":"/"},"favicon":"https://mintcdn.com/seekr/xCjyiASvtfX59CGv/favicon.png?fit=max\u0026auto=format\u0026n=xCjyiASvtfX59CGv\u0026q=85\u0026s=7d7b7568b4fc9d19a790b3f0b5c28d87","appearance":{"default":"system"},"background":{"color":{"light":"#F7F7F7","dark":"#101010"}},"navbar":{"links":[{"href":"https://apps.seekr.com/signup?_gl=1*1t0lzvp*_gcl_au*MjY4NjQ1Mzg3LjE3ODEyNDExMjU.","label":"Get started"}],"primary":{"type":"button","label":"Request a demo","href":"https://www.seekr.com/request-a-demo/"}},"footer":{"socials":{"youtube":"https://www.youtube.com/@seekrtechnologies","x":"https://x.com/seekrtechnology","linkedin":"https://www.linkedin.com/company/seekrtechnologies"}},"seo":{"metatags":{"google-site-verification":"RDMpUYE1uCSa_-TiRs1E4lMyGuAOUVkzmji5t4kVsEM","canonical":"https://docs.seekr.com"}},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/seekr/-zCoynlpxo7UthaS/images/og-background.png?fit=max\u0026auto=format\u0026n=-zCoynlpxo7UthaS\u0026q=85\u0026s=b40b0a1967ede7eaf3cdc61d29d8a437"},"interaction":{"drilldown":false},"metadata":{"timestamp":true},"navigation":{"global":{"tabs":[{"tab":"Self-managed","icon":"server","href":"/self-managed/flow"}],"anchors":[{"anchor":"About us","icon":"circle-info","href":"https://www.seekr.com/about/"},{"anchor":"Contact us","icon":"headset","href":"https://www.seekr.com/contact-us/"},{"anchor":"Blog","icon":"newspaper","href":"https://www.seekr.com/resource-center/?type=blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"seekr","hasAudioNarration":false,"actualSubdomain":"seekr","customDomains":["docs.seekr.com"],"gitSource":{"type":"github","owner":"seekr-technologies","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb4faa1f0e0ab891cd9f26","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"SeekrFlow","count":260},{"language":"default","tag":"Developer","count":184},{"language":"default","tag":"API Reference","count":149},{"language":"default","tag":"Endpoints","count":147},{"language":"default","tag":"Guides","count":50},{"language":"default","tag":"SDK","count":35},{"language":"default","tag":"SeekrFlow SDK","count":35},{"language":"default","tag":"Agents","count":29},{"language":"default","tag":"Self-managed","count":29},{"language":"default","tag":"Deployment guides","count":27}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":true},"customCss":[{"filePath":"print.css","content":"@media print{#navbar,#sidebar,#table-of-contents,#pagination,#banner,#footer,footer,advanced-footer,.contextual-feedback-container{display:none!important}.card,.card *{border:none!important;box-shadow:none!important;background:none!important;border-radius:0!important;ring:none!important}card-group,columns{display:block!important}callout{border-left:2px solid #000!important;background:none!important;padding:0.25rem 0.5rem!important}#content-area{width:100%!important;max-width:100%!important;margin:0!important;padding:0!important}code-block{page-break-inside:avoid}step{page-break-inside:avoid}}"},{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\ntable code{white-space:nowrap}.font-mono,code,kbd,samp,pre,pre code{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important}.prose :not(pre)>code{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important;padding-left:0.2em!important;padding-right:0.2em!important;background-color:rgba(65, 68, 71, 0.08)!important}.dark .prose :not(pre)>code{background-color:rgba(255, 255, 255, 0.10)!important}.eyebrow{color:#D03722!important;font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important;text-transform:uppercase!important;font-weight:600!important}.dark .eyebrow{color:#E2513D!important}.breadcrumb-item,.breadcrumb-item a,.breadcrumb-item svg{color:#D03722!important;font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important;text-transform:uppercase!important;font-weight:600!important}.dark .breadcrumb-item,.dark .breadcrumb-item a,.dark .breadcrumb-item svg{color:#E2513D!important}.breadcrumb-item svg{opacity:0.55!important}.breadcrumb-item a:hover{color:#A82B1B!important}.dark .breadcrumb-item a:hover{color:#F2705C!important}.card{background-color:#FFFFFF!important;border-color:#D5D6D7!important}.dark .card{background-color:#272628!important;border-color:#414447!important}.code-group{background-color:#FFFFFF!important;border-color:#D5D6D7!important}.code-block-background{background-color:#FFFFFF!important}.code-group .code-block-background{background-color:#F7F7F7!important}.dark .code-group{background-color:#272628!important;border-color:#414447!important}.dark .code-block-background{background-color:#272628!important}.prose{color:#101010!important}.dark .prose{color:#FFFFFF!important}.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6,.prose strong,.prose b,.prose th{color:#101010!important}.dark .prose h1,.dark .prose h2,.dark .prose h3,.dark .prose h4,.dark .prose h5,.dark .prose h6,.dark .prose strong,.dark .prose b,.dark .prose th{color:#FFFFFF!important}.prose-gray{--tw-prose-bullets: #101010 !important;--tw-prose-counters: #101010 !important}.dark .prose-gray{--tw-prose-bullets: #FFFFFF !important;--tw-prose-counters: #FFFFFF !important}.prose :is(p,li,td,th,dd,blockquote,h1,h2,h3,h4,h5,h6) a,.prose :is(p,li,td,th,dd,blockquote,h1,h2,h3,h4,h5,h6) a *{color:#007774!important}.dark .prose :is(p,li,td,th,dd,blockquote,h1,h2,h3,h4,h5,h6) a,.dark .prose :is(p,li,td,th,dd,blockquote,h1,h2,h3,h4,h5,h6) a *{color:#00DAD3!important}[data-component-part=\"step-number\"] .rounded-full{background-color:transparent!important;border:2px solid #D5D6D7!important;border-radius:9999px!important;color:#101010!important;font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace!important}[data-component-part=\"step-number\"] .rounded-full *{color:#101010!important}.dark [data-component-part=\"step-number\"] .rounded-full{border-color:#414447!important;color:#FFFFFF!important}.dark [data-component-part=\"step-number\"] .rounded-full *{color:#FFFFFF!important}[data-component-part=\"step-line\"]{background-image:linear-gradient(to bottom, #D5D6D7, #D5D6D7 80%, transparent)!important}.dark [data-component-part=\"step-line\"]{background-image:linear-gradient(to bottom, #414447, #414447 80%, transparent)!important}.callout [data-component-part=\"callout-content\"]{color:#101010!important}.dark .callout [data-component-part=\"callout-content\"]{color:#FFFFFF!important}.callout[data-callout-type=\"info\"]{background-color:rgba(65, 68, 71, 0.06)!important;border-color:#D5D6D7!important}[data-callout-type=\"info\"] [data-component-part=\"callout-icon\"] svg{color:#414447!important}.dark .callout[data-callout-type=\"info\"]{background-color:rgba(255, 255, 255, 0.05)!important;border-color:#595C5F!important}.dark [data-callout-type=\"info\"] [data-component-part=\"callout-icon\"] svg{color:#D5D6D7!important}.callout[data-callout-type=\"tip\"]{background-color:#E9FFF5!important;border-color:#79EEB7!important}[data-callout-type=\"tip\"] [data-component-part=\"callout-icon\"] svg{color:#269B63!important}.dark .callout[data-callout-type=\"tip\"]{background-color:rgba(38, 155, 99, 0.20)!important;border-color:#269B63!important}.dark [data-callout-type=\"tip\"] [data-component-part=\"callout-icon\"] svg{color:#3FD78F!important}.callout[data-callout-type=\"note\"]{background-color:#E0EFFF!important;border-color:#8CC6FF!important}[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"] svg{color:#0B5EB8!important}.dark .callout[data-callout-type=\"note\"]{background-color:rgba(11, 94, 184, 0.20)!important;border-color:#0B5EB8!important}.dark [data-callout-type=\"note\"] [data-component-part=\"callout-icon\"] svg{color:#44B4FF!important}.callout[data-callout-type=\"warning\"]{background-color:#FFF7E8!important;border-color:#FFC369!important}[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"] svg{color:#E18F0D!important}.dark .callout[data-callout-type=\"warning\"]{background-color:rgba(225, 143, 13, 0.20)!important;border-color:#E18F0D!important}.dark [data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"] svg{color:#FFBA4B!important}.callout[data-callout-type=\"danger\"]{background-color:#FFF2F2!important;border-color:#FF7077!important}[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"] svg{color:#D30214!important}.dark .callout[data-callout-type=\"danger\"]{background-color:rgba(211, 2, 20, 0.20)!important;border-color:#D30214!important}.dark [data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"] svg{color:#FF7077!important}svg[id^=\"mermaid-\"] .node rect,svg[id^=\"mermaid-\"] .node polygon,svg[id^=\"mermaid-\"] .node circle,svg[id^=\"mermaid-\"] .node path{fill:#FFFFFF!important;stroke:#007774!important}.dark svg[id^=\"mermaid-\"] .node rect,.dark svg[id^=\"mermaid-\"] .node polygon,.dark svg[id^=\"mermaid-\"] .node circle,.dark svg[id^=\"mermaid-\"] .node path{fill:#272628!important;stroke:#00DAD3!important}svg[id^=\"mermaid-\"] .nodeLabel,svg[id^=\"mermaid-\"] .node .label,svg[id^=\"mermaid-\"] .node text{color:#101010!important;fill:#101010!important}.dark svg[id^=\"mermaid-\"] .nodeLabel,.dark svg[id^=\"mermaid-\"] .node .label,.dark svg[id^=\"mermaid-\"] .node text{color:#FFFFFF!important;fill:#FFFFFF!important}svg[id^=\"mermaid-\"] .flowchart-link,svg[id^=\"mermaid-\"] .edgePath .path{stroke:#414447!important}svg[id^=\"mermaid-\"] .marker,svg[id^=\"mermaid-\"] marker path{fill:#414447!important;stroke:#414447!important}.dark svg[id^=\"mermaid-\"] .flowchart-link,.dark svg[id^=\"mermaid-\"] .edgePath .path{stroke:#595C5F!important}.dark svg[id^=\"mermaid-\"] .marker,.dark svg[id^=\"mermaid-\"] marker path{fill:#595C5F!important;stroke:#595C5F!important}svg[id^=\"mermaid-\"] .edgeLabel,svg[id^=\"mermaid-\"] .edgeLabel p{color:#101010!important;background-color:#F7F7F7!important}svg[id^=\"mermaid-\"] .edgeLabel rect{fill:#F7F7F7!important;opacity:1!important}.dark svg[id^=\"mermaid-\"] .edgeLabel,.dark svg[id^=\"mermaid-\"] .edgeLabel p{color:#FFFFFF!important;background-color:#101010!important}.dark svg[id^=\"mermaid-\"] .edgeLabel rect{fill:#101010!important}html[data-current-path=\"/\"] .nav-tabs,html[data-current-path=\"/\"] [data-component-part=\"products-selector-trigger\"]{display:none!important}html[data-current-path^=\"/self-managed\"] .nav-tabs .nav-tabs-item[href=\"/self-managed/flow\"]:last-child{display:none!important}div:has(>[data-component-part=\"version-select-trigger\"]){order:1!important}"}],"page":{"pagePath":"flow/sdk/agents","slug":"/flow/sdk/agents","pageMetadata":{"title":"Agents","description":"Build and run agents programmatically with the SeekrFlow Python SDK.","href":"/flow/sdk/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: \"Build and run agents programmatically with the SeekrFlow Python SDK.\"\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={p:`p`,..._provideComponents(),...props.components},{Card,CardGroup}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`An agent is an AI system that reasons through problems and executes tasks autonomously. Agents are configured by specifying models, tools, instructions, and reasoning approach—providing everything needed to accomplish tasks from simple workflows to complex, open-ended objectives.`}),`\n`,_jsx(_components.p,{children:`Use the SeekrFlow Python SDK to build and run agents programmatically. This section covers the core building blocks:`}),`\n`,_jsxs(CardGroup,{children:[_jsx(Card,{title:`Create and manage agents`,icon:`robot`,href:`/flow/sdk/agents/create-agents`,children:_jsx(_components.p,{children:`Configure agents, reasoning effort, and tools.`})}),_jsx(Card,{title:`Run an agent`,icon:`play`,href:`/flow/sdk/agents/run-an-agent`,children:_jsx(_components.p,{children:`Use threads, messages, and runs to run your agent.`})}),_jsx(Card,{title:`Use structured outputs`,icon:`brackets-curly`,href:`/flow/sdk/agents/structured-outputs`,children:_jsx(_components.p,{children:`Control the format of agent responses.`})}),_jsx(Card,{title:`Tools`,icon:`screwdriver-wrench`,href:`/flow/sdk/agents/tools`,children:_jsx(_components.p,{children:`Extend agent capabilities with file search, web search, code interpreter, custom tools, and more.`})})]})]})}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":"Build and run agents programmatically with the SeekrFlow Python SDK.","href":"/flow/sdk/agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"seekr","siteName":"Seekr Documentation","title":"Agents - Seekr Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-24T16:04:43.754Z","gitLastModified":"2026-06-24T16:03:57.000Z","originalFileLocation":"flow/sdk/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=\"Build and run agents programmatically with the SeekrFlow Python SDK.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Seekr Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_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/seekr/stRf9o-EBn2ru4KI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agents - Seekr Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build and run agents programmatically with the SeekrFlow Python SDK.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Seekr Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.seekr.com/flow/sdk/agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://seekr.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Agents\u0026amp;description=Build+and+run+agents+programmatically+with+the+SeekrFlow+Python+SDK.\u0026amp;theme=005cf4e0d79661173c99c723\u0026amp;signature=d5dfd79eabb17d7bb3a5a187a5f93c31e50b5241921725f52a9644489f3443aa\">\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 - Seekr Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build and run agents programmatically with the SeekrFlow Python SDK.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://seekr.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Agents\u0026amp;description=Build+and+run+agents+programmatically+with+the+SeekrFlow+Python+SDK.\u0026amp;theme=005cf4e0d79661173c99c723\u0026amp;signature=d5dfd79eabb17d7bb3a5a187a5f93c31e50b5241921725f52a9644489f3443aa\">\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/seekr/stRf9o-EBn2ru4KI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Seekr Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007774\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"RDMpUYE1uCSa_-TiRs1E4lMyGuAOUVkzmji5t4kVsEM\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.seekr.com/flow/sdk/agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/flow/sdk/agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.seekr.com/#organization\",\"name\":\"Seekr Documentation\",\"url\":\"https://docs.seekr.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/seekr/xCjyiASvtfX59CGv/logo/light.svg?fit=max\u0026auto=format\u0026n=xCjyiASvtfX59CGv\u0026q=85\u0026s=5631304b029d4cfaefb138711ec30bd9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.seekr.com#website\",\"name\":\"Seekr Documentation\",\"url\":\"https://docs.seekr.com\",\"publisher\":{\"@id\":\"https://docs.seekr.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.seekr.com/flow/sdk/agents#webpage\",\"url\":\"https://docs.seekr.com/flow/sdk/agents\",\"name\":\"Agents\",\"description\":\"Build and run agents programmatically with the SeekrFlow Python SDK.\",\"dateModified\":\"2026-06-24T16:03:57.000Z\",\"isPartOf\":{\"@id\":\"https://docs.seekr.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.seekr.com/flow/sdk/agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.seekr.com/flow/sdk/agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SeekrFlow SDK\",\"item\":\"https://docs.seekr.com/flow/sdk/getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.seekr.com/flow/sdk/agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.seekr.com/flow/sdk/agents#article\",\"headline\":\"Agents\",\"name\":\"Agents\",\"description\":\"Build and run agents programmatically with the SeekrFlow Python SDK.\",\"url\":\"https://docs.seekr.com/flow/sdk/agents\",\"mainEntityOfPage\":{\"@id\":\"https://docs.seekr.com/flow/sdk/agents#webpage\"},\"dateModified\":\"2026-06-24T16:03:57.000Z\",\"publisher\":{\"@id\":\"https://docs.seekr.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.seekr.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Seekr Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Seekr Documentation","nav":{"global":{"tabs":[{"tab":"Self-managed","icon":"server","href":"/self-managed/flow"}],"anchors":[{"anchor":"About us","icon":"circle-info","href":"https://www.seekr.com/about/"},{"anchor":"Contact us","icon":"headset","href":"https://www.seekr.com/contact-us/"},{"anchor":"Blog","icon":"newspaper","href":"https://www.seekr.com/resource-center/?type=blog"}]},"products":[{"product":"SeekrFlow","icon":"circle-nodes","description":"Build, tune, and deploy enterprise AI agents","tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/flow/what-is-seekrflow"}]},{"tab":"Developer","icon":"code","menu":[{"item":"SDK","icon":"cube","groups":[{"group":"SeekrFlow SDK","pages":[{"title":"Get started with the SDK","sidebarTitle":"Get started","href":"/flow/sdk/getting-started"},{"title":"Work with teams","description":"Scope SDK requests to a team so resources are created in and read from the right place.","href":"/flow/sdk/teams"},{"group":"Agents","root":{"title":"Agents","href":"/flow/sdk/agents"},"pages":[{"title":"Create and manage agents","description":"Create, configure, and manage agents using the SeekrFlow Python SDK.","href":"/flow/sdk/agents/create-agents"},{"title":"Run an agent","description":"Use threads and messages to start runs and retrieve agent responses.","href":"/flow/sdk/agents/run-an-agent"},{"title":"Use structured outputs","description":"Control the format of agent responses using Pydantic models or JSON schemas.","href":"/flow/sdk/agents/structured-outputs"},{"group":"Tools","root":{"title":"Tools","href":"/flow/sdk/agents/tools"},"pages":[{"title":"File search","description":"Retrieve relevant data from a vector database using semantic search.","href":"/flow/sdk/agents/filesearch-tool"},{"title":"Web search","description":"Real-time information retrieval from web sources.","href":"/flow/sdk/agents/websearch-tool"},{"title":"Custom tools","description":"Developer-defined Python functions for specialized business logic.","href":"/flow/sdk/agents/custom-tools"},{"title":"Agent as tool","description":"Use agents as callable tools to build multi-agent workflows.","href":"/flow/sdk/agents/agent-as-tool"},{"title":"MCP connector","description":"Connect a remote MCP server to your agent so it can invoke external tools without a custom integration.","href":"/flow/sdk/agents/mcp-connector"}]}]},{"group":"Data engine","root":{"title":"Data engine","href":"/flow/sdk/data-engine"},"pages":[{"title":"Prepare and ingest files","href":"/flow/sdk/data-engine/file-ingestion"},{"title":"Monitor ingestion","href":"/flow/sdk/data-engine/monitor-ingestion"},{"title":"Create and populate a vector database","href":"/flow/sdk/data-engine/create-and-populate-a-vector-database"},{"title":"Choose a chunking method","href":"/flow/sdk/data-engine/choose-chunking-method"},{"title":"Manage vector databases","href":"/flow/sdk/data-engine/manage-vector-databases"},{"title":"Manage chunk metadata","href":"/flow/sdk/data-engine/manage-chunk-metadata"},{"title":"Generate a metadata snapshot","href":"/flow/sdk/data-engine/generate-metadata-snapshot"},{"title":"Create instruction fine-tuning data","href":"/flow/sdk/data-engine/standard-instruction-finetuning"},{"title":"Create context-grounded fine-tuning data","href":"/flow/sdk/data-engine/context-grounded-fine-tuning-data"},{"title":"Manage data jobs","href":"/flow/sdk/data-engine/manage-data-jobs"},{"title":"Use AWS Bedrock for ingestion and inference","href":"/flow/sdk/data-engine/aws-bedrock"}]},{"group":"Fine-tuning","root":{"title":"Fine-tuning","href":"/flow/sdk/fine-tuning"},"pages":[{"title":"Create a fine-tuning job","href":"/flow/sdk/fine-tuning/create-fine-tuning-job"},{"title":"Reinforcement tuning","href":"/flow/sdk/fine-tuning/grpo-fine-tuning"},{"title":"Preference tuning","href":"/flow/sdk/fine-tuning/preference-tuning"},{"title":"Vision language tuning","href":"/flow/sdk/fine-tuning/vision-language-tuning"},{"title":"Low-rank adaptation","href":"/flow/sdk/fine-tuning/lora"},{"title":"Deploy a fine-tuned model for inference","href":"/flow/sdk/fine-tuning/promote-a-fine-tuned-model"}]},{"title":"Deployments","href":"/flow/sdk/deployments"},{"group":"Explainability","root":{"title":"Explainability","href":"/flow/sdk/explainability"},"pages":[{"title":"Attribute a response to its sources","sidebarTitle":"Attribute to sources","href":"/flow/sdk/explainability/context-attribution"},{"title":"Attribute a response to training data","sidebarTitle":"Attribute to training data","href":"/flow/sdk/explainability/training-data-attribution"},{"title":"Trace a response to source documents","sidebarTitle":"Trace to source documents","href":"/flow/sdk/explainability/source-tracing"}]},{"title":"Observability","href":"/flow/sdk/observability"},{"title":"Manage and delete resources","href":"/flow/sdk/resource-management"},{"group":"Integrations","root":{"title":"Integrations","href":"/flow/sdk/integrations"},"pages":[{"title":"OpenAI","href":"/flow/sdk/integrations/custom-functions"},{"title":"LangChain","href":"/flow/sdk/integrations/using-seekrflow-langchain"}]}]}]},{"item":"API Reference","icon":"terminal","pages":[{"title":"API Reference","href":"/flow/reference/getting-started-with-your-api"}]}]},{"tab":"Recipes","icon":"flask","pages":[{"title":"Recipes","href":"/flow/recipes"}]},{"tab":"Release notes","icon":"bullhorn","pages":[{"title":"Release notes","href":"/flow/changelog/2026"}]}]},{"product":"SeekrGuard","icon":"shield-halved","description":"Evaluate AI models for safety, quality, and risk","pages":[{"title":"SeekrGuard","href":"/guard/what-is-seekrguard"}]},{"product":"Self-managed","icon":"server","description":"Deploy and operate the Seekr platform in your own environment","pages":[{"title":"Self-managed","href":"/self-managed/flow"}]}]},"basePath":"","title":"Agents - Seekr Documentation","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}