In Sidecar, select Agents, then select Builder.Builder does not ship with presets, so you create this job from scratch.
Open Builder, then click New job.
2
Start a new job
Click New job.Enter these values:
Setting
Value
Name
Update repository documentation
Description
Correct one small documentation issue and open a pull request.
Instructions
Use the example below.
Repositories
Select one repository.
Delivery
Open a pull request
Trigger
Manual
Review the repository documentation for one small, clearly incorrect oroutdated statement. Correct it, preserve the existing style, and validateany affected links or formatting. Do not change application code.
Selecting one repository keeps the first run focused. An empty repository selection means all currently accessible repositories.
Populate the job and select one repository for the first run.
3
Create the job
Click Create job. Sidecar opens the job configuration page.
4
Review the job settings
Confirm these settings before the first run:
Scope contains only the repository you selected.
Completion and output is set to Open a pull request.
Schedule and trigger is set to Manual.
MCP servers can stay at its default. This task does not require an MCP server.
Tool permissions is set to Autonomous.
Autonomous mode lets gateable tools run without pausing. Core repository tools are always available. You can use Supervised for later jobs when you want gateable web or MCP tools to require Account Admin approval.
Review the job's scope, trigger, MCP access, and tool permissions before running it.
5
Run the job
Click Run now.Sidecar opens the run detail page. The run moves from Queued to Running while Builder reads the repository, makes the change, and validates it.
The run detail page updates while Builder is working.
6
Review the result
When the run finishes, open its artifact. Review the pull request and its checks before merging.Builder never merges its own changes.
Open the source-control artifact when the run succeeds.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sidecar Data","colors":{"primary":"#6C5CE7","light":"#A29BFE","dark":"#5A4BD1"},"logo":{"light":"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/logo/light.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=aec7588a8692437b4d852ab8853fe7f2","dark":"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/logo/dark.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=20ae096a0358923d866fe799a20ad512"},"favicon":"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/favicon.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=e509d86c08a6d2f23fcc026c6742c110","navbar":{"links":[{"href":"mailto:support@sidecardata.com","label":"Support"}],"primary":{"type":"button","label":"Login","href":"https://app.sidecardata.com"}},"footer":{"socials":{"website":"https://sidecardata.com","linkedin":"https://www.linkedin.com/company/sidecar-data"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","icon":"browser","href":"https://app.sidecardata.com"},{"anchor":"Contact Us","icon":"envelope","href":"mailto:support@sidecardata.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sidecardatainc","hasAudioNarration":false,"actualSubdomain":"sidecardatainc","customDomains":["docs.sidecardata.com"],"gitSource":{"type":"github","owner":"sidecar-data","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afcac5891717461faf6c9ad","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Integrations","count":26},{"language":"default","tag":"Products","count":23},{"language":"default","tag":"Agent Console","count":16},{"language":"default","tag":"MCP","count":7},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"BI \u0026 Analytics","count":6},{"language":"default","tag":"Set up","count":5},{"language":"default","tag":"Data Warehouses","count":4},{"language":"default","tag":"Jobs","count":3},{"language":"default","tag":"Guides","count":2}]},"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":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"products/agent-console/quickstart","slug":"/products/agent-console/quickstart","pageMetadata":{"title":"Create your first Agent Console job","sidebarTitle":"Quickstart","description":"Create and run a Builder job that makes a reviewable documentation change","icon":"rocket","href":"/products/agent-console/quickstart"},"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: \"Create and run a Builder job that makes a reviewable documentation change\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`In this quickstart, you create a manual Builder job that updates documentation in one repository and opens a pull request for review.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsx(_components.p,{children:`You need:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An Account Admin role in Sidecar`}),`\n`,_jsx(_components.li,{children:`Agent Console enabled for your workspace`}),`\n`,_jsx(_components.li,{children:`A connected GitHub or GitLab repository where you can safely make a documentation change`}),`\n`,_jsx(_components.li,{children:`Permission to review pull or merge requests in that repository`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If the repository is not connected, complete `,_jsx(_components.a,{href:`/products/agent-console/setup/connect-repositories`,children:`Connect repositories`}),` first.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-the-job`,children:`Create the job`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open Builder`,children:[_jsxs(_components.p,{children:[`In Sidecar, select `,_jsx(_components.strong,{children:`Agents`}),`, then select `,_jsx(_components.strong,{children:`Builder`}),`.`]}),_jsx(_components.p,{children:`Builder does not ship with presets, so you create this job from scratch.`}),_jsx(Frame,{caption:`Open Builder, then click New job.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=69163d6d0dcd6ff429a2d4e937fb7302`,alt:`Builder agent page with the New job button`,\"data-og-width\":`1230`,width:`1230`,\"data-og-height\":`650`,height:`650`,\"data-path\":`images/agent-console/quickstart/open-builder.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?w=280\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=de4f763c3d56bc19c53adb9b88b47e3c 280w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?w=560\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=6a2563b1a0515629bf37f3d39c54d9f1 560w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?w=840\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=38a63b5c36819312467e6d6cc6d34a04 840w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?w=1100\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=df21e271b726fb6c5424c4f2d5985c5e 1100w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?w=1650\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=ee609e596a131d45a35f4b5d838784a6 1650w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/open-builder.png?w=2500\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=ffbcaded05feceb01b1fe47426e890b2 2500w`})})]}),_jsxs(Step,{title:`Start a new job`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`New job`}),`.`]}),_jsx(_components.p,{children:`Enter these values:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Update repository documentation`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Description`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Correct one small documentation issue and open a pull request.`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Instructions`})}),_jsx(_components.td,{children:`Use the example below.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Repositories`})}),_jsx(_components.td,{children:`Select one repository.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delivery`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Open a pull request`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Trigger`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Manual`})})]})]})]}),_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Review the repository documentation for one small, clearly incorrect or`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`outdated statement. Correct it, preserve the existing style, and validate`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`any affected links or formatting. Do not change application code.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Selecting one repository keeps the first run focused. An empty repository selection means all currently accessible repositories.`}),_jsx(Frame,{caption:`Populate the job and select one repository for the first run.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=acdf61094dd2fc5677881601193a53db`,alt:`New Builder job populated with documentation instructions and one selected repository`,\"data-og-width\":`620`,width:`620`,\"data-og-height\":`690`,height:`690`,\"data-path\":`images/agent-console/quickstart/new-builder-job.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?w=280\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=fe9feb4f9b73261ace2e13985e3db389 280w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?w=560\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=5055437cd482d5a2966083c3053aaa5b 560w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?w=840\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=9335e0161b40c0614ca912865847db77 840w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?w=1100\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=3396444297b81cf722a07fe251168e38 1100w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?w=1650\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=979a6a125a1a5cb91e09c61cf3f15134 1650w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/new-builder-job.png?w=2500\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=d34d004f851d3dd42e97580f8866d849 2500w`})})]}),_jsx(Step,{title:`Create the job`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Create job`}),`. Sidecar opens the job configuration page.`]})}),_jsxs(Step,{title:`Review the job settings`,children:[_jsx(_components.p,{children:`Confirm these settings before the first run:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Scope`}),` contains only the repository you selected.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Completion and output`}),` is set to `,_jsx(_components.strong,{children:`Open a pull request`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Schedule and trigger`}),` is set to `,_jsx(_components.strong,{children:`Manual`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`MCP servers`}),` can stay at its default. This task does not require an MCP server.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tool permissions`}),` is set to `,_jsx(_components.strong,{children:`Autonomous`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`Autonomous mode lets gateable tools run without pausing. Core repository tools are always available. You can use `,_jsx(_components.strong,{children:`Supervised`}),` for later jobs when you want gateable web or MCP tools to require Account Admin approval.`]}),_jsx(Frame,{caption:`Review the job's scope, trigger, MCP access, and tool permissions before running it.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=6c44266105f2b2d726edfa8033092523`,alt:`Builder job configuration with repository scope, Manual trigger, MCP server selection, and Autonomous permissions`,\"data-og-width\":`1230`,width:`1230`,\"data-og-height\":`1450`,height:`1450`,\"data-path\":`images/agent-console/quickstart/review-job-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=120e6862e9ec09073589e4e79ca8e58c 280w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=989518bf236068a5ccacd9486c80372d 560w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=4de7f025dfacb2ff4d1d14de62c54eac 840w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=4d0222fc12309aa85a65e22158698c1b 1100w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=ac468e14a72e2b4ece2e611acd23de5d 1650w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/review-job-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=a4f1491cd077dfa1c76d514432155df4 2500w`})})]}),_jsxs(Step,{title:`Run the job`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Run now`}),`.`]}),_jsxs(_components.p,{children:[`Sidecar opens the run detail page. The run moves from `,_jsx(_components.strong,{children:`Queued`}),` to `,_jsx(_components.strong,{children:`Running`}),` while Builder reads the repository, makes the change, and validates it.`]}),_jsx(Frame,{caption:`The run detail page updates while Builder is working.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=6b2568d4e8209225266839237dc796bc`,alt:`Running scheduled Builder job with its first turn visible`,\"data-og-width\":`1230`,width:`1230`,\"data-og-height\":`650`,height:`650`,\"data-path\":`images/agent-console/quickstart/run-in-progress.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?w=280\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=ec58b5a09d0c154226e67c833b74f82e 280w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?w=560\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=f93ba0f8dd14c70fc734bb8d106eafe1 560w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?w=840\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=48f1644be4af25e049c02c0f1d70ea31 840w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?w=1100\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=400433a9aef8031d548c6f4d33fb2907 1100w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?w=1650\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=27483a38d198a1a9c10a239870a160f2 1650w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/quickstart/run-in-progress.png?w=2500\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=fcf74e9759d9e0c51b979e25fadb26df 2500w`})})]}),_jsxs(Step,{title:`Review the result`,children:[_jsx(_components.p,{children:`When the run finishes, open its artifact. Review the pull request and its checks before merging.`}),_jsx(_components.p,{children:`Builder never merges its own changes.`}),_jsx(Frame,{caption:`Open the source-control artifact when the run succeeds.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=62774c8fe344df179252105546d40eac`,alt:`Succeeded Builder run with a pull request artifact and final answer`,\"data-og-width\":`1866`,width:`1866`,\"data-og-height\":`1308`,height:`1308`,\"data-path\":`images/agent-console/run-artifacts.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?w=280\u0026fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=032c23efb3d517781f0464a206b7406c 280w, https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?w=560\u0026fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=b169c38626c9a08287a27b475f25736f 560w, https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?w=840\u0026fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=9be6f3a6653d37ab8c9781c41422e8af 840w, https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=e3684833853e8e5b1e7f1f62277923b0 1100w, https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=1145f86918da31f7af35cfb63581697b 1650w, https://mintcdn.com/sidecardatainc/2zErf1Ry2RIr8nOH/images/agent-console/run-artifacts.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2zErf1Ry2RIr8nOH\u0026q=85\u0026s=98fa16d8647bdebc3c323276f882fa41 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Learn how to `,_jsx(_components.a,{href:`/products/agent-console/jobs/create-a-job#from-a-preset`,children:`create jobs from presets`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/integrations/mcp-servers/connect-an-mcp-server`,children:`Connect an MCP server`}),`, then `,_jsx(_components.a,{href:`/products/agent-console/setup/give-agents-mcp-access`,children:`give an agent access`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/products/agent-console/jobs/configure-a-job#schedule-and-trigger`,children:`Create a schedule`}),` for recurring work.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/products/agent-console/run-an-agent-from-slack`,children:`Run an agent from Slack`}),` for an ad hoc request.`]}),`\n`]})]})}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 your first Agent Console job","sidebarTitle":"Quickstart","description":"Create and run a Builder job that makes a reviewable documentation change","icon":"rocket","href":"/products/agent-console/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Create the job","slug":"create-the-job","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sidecardatainc","siteName":"Sidecar Data","title":"Create your first Agent Console job - Sidecar Data","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-29T22:32:37.893Z","originalFileLocation":"products/agent-console/quickstart.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=\"Create and run a Builder job that makes a reviewable documentation change\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sidecar Data\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create your first Agent Console job - Sidecar Data\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create and run a Builder job that makes a reviewable documentation change\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sidecar Data\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sidecardata.com/products/agent-console/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sidecardatainc.mintlify.site/_mintlify/api/og/v2?division=Agent+Console\u0026amp;title=Create+your+first+Agent+Console+job\u0026amp;description=Create+and+run+a+Builder+job+that+makes+a+reviewable+documentation+change\u0026amp;theme=5947409eff6b7237b55156b9\u0026amp;signature=2c922d01106e4f603653e22f60344d1bb72a8dab3ebfd65cd133366a20bcead5\">\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 your first Agent Console job - Sidecar Data\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create and run a Builder job that makes a reviewable documentation change\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sidecardatainc.mintlify.site/_mintlify/api/og/v2?division=Agent+Console\u0026amp;title=Create+your+first+Agent+Console+job\u0026amp;description=Create+and+run+a+Builder+job+that+makes+a+reviewable+documentation+change\u0026amp;theme=5947409eff6b7237b55156b9\u0026amp;signature=2c922d01106e4f603653e22f60344d1bb72a8dab3ebfd65cd133366a20bcead5\">\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/sidecardatainc/ohweD8I7CbJrnp7k/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sidecar Data\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C5CE7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sidecardata.com/products/agent-console/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/agent-console/quickstart.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sidecardata.com/#organization\",\"name\":\"Sidecar Data\",\"url\":\"https://docs.sidecardata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/logo/light.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=aec7588a8692437b4d852ab8853fe7f2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sidecardata.com#website\",\"name\":\"Sidecar Data\",\"url\":\"https://docs.sidecardata.com\",\"publisher\":{\"@id\":\"https://docs.sidecardata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sidecardata.com/products/agent-console/quickstart#webpage\",\"url\":\"https://docs.sidecardata.com/products/agent-console/quickstart\",\"name\":\"Create your first Agent Console job\",\"description\":\"Create and run a Builder job that makes a reviewable documentation change\",\"dateModified\":\"2026-07-29T22:32:37.893Z\",\"isPartOf\":{\"@id\":\"https://docs.sidecardata.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sidecardata.com/products/agent-console/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sidecardata.com/products/agent-console/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agent Console\",\"item\":\"https://docs.sidecardata.com/products/agent-console/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create your first Agent Console job\",\"item\":\"https://docs.sidecardata.com/products/agent-console/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sidecardata.com/products/agent-console/quickstart#article\",\"headline\":\"Create your first Agent Console job\",\"name\":\"Create your first Agent Console job\",\"description\":\"Create and run a Builder job that makes a reviewable documentation change\",\"url\":\"https://docs.sidecardata.com/products/agent-console/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sidecardata.com/products/agent-console/quickstart#webpage\"},\"dateModified\":\"2026-07-29T22:32:37.893Z\",\"publisher\":{\"@id\":\"https://docs.sidecardata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sidecardata.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sidecar Data\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sidecar Data\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/products/agent-console/quickstart.md","siteName":"Sidecar Data","nav":{"global":{"anchors":[{"anchor":"App","icon":"browser","href":"https://app.sidecardata.com"},{"anchor":"Contact Us","icon":"envelope","href":"mailto:support@sidecardata.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Products","groups":[{"group":"Agent Console","pages":[{"title":"Agent Console","sidebarTitle":"Overview","description":"Configure Sidecar agents, create repeatable jobs, and review their runs","icon":"terminal","href":"/products/agent-console/overview"},{"title":"Create your first Agent Console job","sidebarTitle":"Quickstart","icon":"rocket","href":"/products/agent-console/quickstart"},{"group":"Agents","root":{"title":"Choose an agent","description":"Compare the live Agent Console agents and choose the right one for your task","icon":"users","href":"/products/agent-console/agents/choose-an-agent"},"expanded":true,"pages":[{"title":"Builder","icon":"hammer","href":"/products/agent-console/agents/builder"},{"title":"Reliability","icon":"heart-pulse","href":"/products/agent-console/agents/reliability"},{"title":"Optimization","icon":"gauge-high","href":"/products/agent-console/agents/optimization"},{"title":"Custodian","icon":"shield-check","href":"/products/agent-console/agents/custodian"}]},{"group":"Set up","root":{"title":"Set up Agent Console","icon":"sliders","href":"/products/agent-console/setup/overview"},"pages":[{"title":"Connect repositories","icon":"git-branch","href":"/products/agent-console/setup/connect-repositories"},{"title":"Connect dbt context","icon":"diagram-project","href":"/products/agent-console/setup/connect-dbt"},{"title":"Give agents MCP access","icon":"key","href":"/products/agent-console/setup/give-agents-mcp-access"},{"title":"Provide knowledge to agents","icon":"book-open","href":"/products/agent-console/setup/provide-knowledge"},{"title":"Configure agent defaults","icon":"settings","href":"/products/agent-console/setup/configure-agent-defaults"}]},{"group":"Jobs","pages":[{"title":"Create a job","icon":"circle-plus","href":"/products/agent-console/jobs/create-a-job"},{"title":"Configure a job","icon":"sliders","href":"/products/agent-console/jobs/configure-a-job"},{"title":"Runs and approvals","icon":"list-check","href":"/products/agent-console/jobs/runs-and-approvals"}]},{"title":"Run an agent from Slack","icon":"slack","href":"/products/agent-console/run-an-agent-from-slack"},{"group":"Recipes","pages":[{"title":"Review upstream changes for downstream impact","sidebarTitle":"Custodian downstream-impact review","icon":"shield-check","href":"/products/agent-console/recipes/custodian-downstream-impact-review"}]}]},{"group":"Observability","pages":[{"title":"Monitors as code","icon":"code-branch","href":"/products/observability/monitors-as-code"},{"title":"Agent skill for monitors as code","icon":"robot","href":"/products/observability/monitors-as-code-agent-skill"}]},{"group":"Context Garage","pages":[{"title":"Context Garage key concepts","icon":"warehouse","href":"/products/context-garage/key-concepts"},{"title":"Context Garage quickstart","icon":"rocket","href":"/products/context-garage/quickstart"}]},{"group":"Agents","pages":[{"title":"Ask Sidecar with Snowflake query execution","icon":"snowflake","href":"/products/agents/ask-sidecar-snowflake"},{"title":"Contract Agent quickstart","icon":"file-contract","href":"/products/agents/contract-agent"},{"title":"Sidecar Engineer for Jira quickstart","icon":"jira","href":"/products/agents/sidecar-engineer/jira-quickstart"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/source-control/github"}]}]},"basePath":"","title":"Create your first Agent Console job - Sidecar Data","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}