name: merged_prsdescription: Pull requests merged into this repository since a date, as number, title and merge time.kind: execcommand: ghargs: - pr - list - --state - merged - --search - "merged:>={{input.since}}" - --json - number,title,mergedAtread_only: trueinput_schema: type: object required: [since] properties: since: type: string description: The earliest merge date, as YYYY-MM-DD
Guides
Create a tool in the workbench
Draft a tool with the tool drafter, test-run it, and save it.
name: merged_prsdescription: Pull requests merged into this repository since a date, as number, title and merge time.kind: execcommand: ghargs: - pr - list - --state - merged - --search - "merged:>={{input.since}}" - --json - number,title,mergedAtread_only: trueinput_schema: type: object required: [since] properties: since: type: string description: The earliest merge date, as YYYY-MM-DD
merged_prs lists the pull requests merged since a date by running the gh CLI.
name: merged_prsdescription: Pull requests merged into this repository since a date, as number, title and merge time.kind: execcommand: ghargs: - pr - list - --state - merged - --search - "merged:>={{input.since}}" - --json - number,title,mergedAtread_only: trueinput_schema: type: object required: [since] properties: since: type: string description: The earliest merge date, as YYYY-MM-DD
1
Open the workbench in tool mode
graph workbench tool
2
Describe the tool
Say what goes in, what comes back, and which command or API it uses. The drafter checks your catalog for a tool that already does it, then puts a first draft in the pane and asks what it can’t settle itself.
The tool drafter's first draft in the pane, with its question in the chat.
3
Test-run it
Answer its questions and ask it to test the tool. It runs the draft on a sample input once you approve the run:
The approval form for a test run, showing the command and the sample input.
The result shows in the pane:
[ { "mergedAt": "2026-10-09T02:25:01Z", "number": 147, "title": "feat!: plans state how they finish with a required finish key…" }, { "mergedAt": "2026-10-08T19:34:56Z", "number": 146, "title": "feat!: workbench agents work on plans through the same artifact tools…" }, …]
4
Save
Press Ctrl+S. graph writes the file to ./.graph/tools/merged_prs.yaml, and the tool is in your catalog as user__merged_prs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"graph","colors":{"primary":"#16A34A","light":"#22C55E","dark":"#15803D"},"favicon":"https://mintcdn.com/graph/Ha85FhxHesay9r1W/favicon.svg?fit=max\u0026auto=format\u0026n=Ha85FhxHesay9r1W\u0026q=85\u0026s=2a0afa5800528a6e2386c904722fddf3","navbar":{"links":[]},"footer":{"socials":{"github":"https://github.com/tylerdavis/graph"}},"variables":{"release_version":"v0.16.0","config_file_version":"4","plan_file_version":"2","tool_file_version":"2","agent_file_version":"1","data_directory_version":"2","pack_file_version":"1","pack_lock_version":"1"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"graph","hasAudioNarration":false,"actualSubdomain":"graph","customDomains":[],"gitSource":{"type":"github","owner":"tylerdavis","repo":"graph","deployBranch":"docs-live","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"2fea3d6f-2d42-495b-900b-9b429fd7f4e5","liveDeploymentHistoryId":"6acefbf9d9195feef044da4d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acefbf9d9195feef044da4d"},"feedback":{"edits":true,"issues":true,"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad69b95267d46225e8c7235","clientVersion":"0.0.3888","searchFilterCounts":[{"language":"default","tag":"Reference","count":129},{"language":"default","tag":"CLI","count":53},{"language":"default","tag":"Tools","count":38},{"language":"default","tag":"Guides","count":27},{"language":"default","tag":"Plans","count":23},{"language":"default","tag":"Integrating","count":20},{"language":"default","tag":"Agents","count":18},{"language":"default","tag":"MCP","count":18},{"language":"default","tag":"Workbench tools","count":16},{"language":"default","tag":"MCP server tools","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"teamspace","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"tools/guides/create-in-workbench","slug":"/tools/guides/create-in-workbench","pageMetadata":{"title":"Create a tool in the workbench","description":"Draft a tool with the tool drafter, test-run it, and save it.","keywords":["tool drafter","workbench","create tool"],"href":"/tools/guides/create-in-workbench"},"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: \"Draft a tool with the tool drafter, test-run it, and save it.\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);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);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`merged_prs`}),` lists the pull requests merged since a date by running the `,_jsx(_components.code,{children:`gh`}),` CLI.`]}),`\n`,`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the workbench in tool mode`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`graph`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` workbench`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tool`})]}),`\n`]})})})}),_jsxs(Step,{title:`Describe the tool`,children:[_jsx(_components.p,{children:`Say what goes in, what comes back, and which command or API it uses. The drafter checks your catalog for a tool that already does it, then puts a first draft in the pane and asks what it can’t settle itself.`}),_jsx(Frame,{caption:`The tool drafter's first draft in the pane, with its question in the chat.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=fa3e35e352e1b7fe7d5f141c2b487e1d`,alt:`The workbench with tool_drafter active: the request and the drafter's question on the left, and the merged_prs draft on the right with its description, kind exec, the gh command it runs, its since input, and no problems.`,\"data-og-width\":`1044`,width:`1044`,\"data-og-height\":`720`,height:`720`,\"data-path\":`images/workbench/tool-drafting.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=280\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=b62bc45594171eb3421f0fb3a397614c 280w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=560\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=f7852d57dc15b246da2df02cfbf03036 560w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=840\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=665c01e4ccfeb9ba0d60dff4962c0e7b 840w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=4905983cff4b318cae4afb03f868319a 1100w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=829ca0fc795e2edffb9d302ad1073b94 1650w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=1517017559c6ad3290535231722b4473 2500w`})})]}),_jsxs(Step,{title:`Test-run it`,children:[_jsx(_components.p,{children:`Answer its questions and ask it to test the tool. It runs the draft on a sample input once you approve the run:`}),_jsx(Frame,{caption:`The approval form for a test run, showing the command and the sample input.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=d29c398d006c88b887ba86938bb5099e`,alt:`The workbench's approval form asking whether to test-run user__merged_prs once with the command gh pr list --state merged --search merged:>={{input.since}} --json number,title,mergedAt and the input since 2026-09-24, with run set to true.`,\"data-og-width\":`1044`,width:`1044`,\"data-og-height\":`720`,height:`720`,\"data-path\":`images/workbench/tool-try.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=280\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=3867f7a8d5ed2101c487881645efa53c 280w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=560\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=c49fee5bb829477929ed8e3acca94652 560w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=840\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=716a74cd8dcc37e920914b9247d34514 840w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=2a53dcbda4fd3882a6aa18d7259525c6 1100w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=225ce11d622006936402d96c3ab5a2b4 1650w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=50b8a1986dfe5c4352b6887788aefd20 2500w`})}),_jsx(_components.p,{children:`The result shows in the pane:`}),_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:`[`})}),`\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:` \"mergedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-09T02:25:01Z\"`}),_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:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`147`}),_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:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"feat!: plans state how they finish with a required finish key…\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mergedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-08T19:34:56Z\"`}),_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:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`146`}),_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:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"feat!: workbench agents work on plans through the same artifact tools…\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:` …`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})})]}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Press `,_jsx(`kbd`,{children:`Ctrl`}),`+`,_jsx(`kbd`,{children:`S`}),`. graph writes the file to `,_jsx(_components.code,{children:`./.graph/tools/merged_prs.yaml`}),`, and the tool is in your catalog as `,_jsx(_components.code,{children:`user__merged_prs`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related guides`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Test a tool`,icon:`flask`,href:`/tools/guides/test-a-tool`,children:_jsx(_components.p,{children:`Run any tool directly and see what it returns.`})}),_jsx(Card,{title:`Tool file`,icon:`file-code`,href:`/tools/reference/tool-file`,children:_jsx(_components.p,{children:`Every field a tool file takes.`})}),_jsx(Card,{title:`Create an agent in the workbench`,icon:`wand-magic-sparkles`,href:`/agents/guides/create-in-workbench`,children:_jsx(_components.p,{children:`Draft an agent that calls your tool.`})}),_jsx(Card,{title:`Draft a plan in the workbench`,icon:`wand-magic-sparkles`,href:`/plans/guides/draft-in-workbench`,children:_jsx(_components.p,{children:`Draft a plan that uses your tool.`})})]})]})}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 a tool in the workbench","description":"Draft a tool with the tool drafter, test-run it, and save it.","keywords":["tool drafter","workbench","create tool"],"href":"/tools/guides/create-in-workbench"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,OptimizedImage,RequestExample,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`merged_prs`}),` lists the pull requests merged since a date by running the `,_jsx(_components.code,{children:`gh`}),` CLI.`]}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`.graph/tools/merged_prs.yaml`,numberOfLines:`21`,language:`yaml`,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:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`21`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`merged_prs`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`description`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Pull requests merged into this repository since a date, as number, title and merge time.`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`kind`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`exec`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`command`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`gh`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`args`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`pr`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`list`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`--state`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`merged`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`--search`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"merged:>={{input.since}}\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`--json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`number,title,mergedAt`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`read_only`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`input_schema`}),_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\":`#569CD6`},children:` type`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`object`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` required`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`since`}),_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\":`#569CD6`},children:` properties`}),_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\":`#569CD6`},children:` since`}),_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\":`#569CD6`},children:` type`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`string`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` description`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`The earliest merge date, as YYYY-MM-DD`})]}),`\n`]})})})}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the workbench in tool mode`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`graph`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` workbench`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tool`})]}),`\n`]})})})}),_jsxs(Step,{title:`Describe the tool`,children:[_jsx(_components.p,{children:`Say what goes in, what comes back, and which command or API it uses. The drafter checks your catalog for a tool that already does it, then puts a first draft in the pane and asks what it can’t settle itself.`}),_jsx(Frame,{caption:`The tool drafter's first draft in the pane, with its question in the chat.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=fa3e35e352e1b7fe7d5f141c2b487e1d`,alt:`The workbench with tool_drafter active: the request and the drafter's question on the left, and the merged_prs draft on the right with its description, kind exec, the gh command it runs, its since input, and no problems.`,\"data-og-width\":`1044`,width:`1044`,\"data-og-height\":`720`,height:`720`,\"data-path\":`images/workbench/tool-drafting.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=280\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=b62bc45594171eb3421f0fb3a397614c 280w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=560\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=f7852d57dc15b246da2df02cfbf03036 560w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=840\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=665c01e4ccfeb9ba0d60dff4962c0e7b 840w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=4905983cff4b318cae4afb03f868319a 1100w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=829ca0fc795e2edffb9d302ad1073b94 1650w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-drafting.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=1517017559c6ad3290535231722b4473 2500w`})})]}),_jsxs(Step,{title:`Test-run it`,children:[_jsx(_components.p,{children:`Answer its questions and ask it to test the tool. It runs the draft on a sample input once you approve the run:`}),_jsx(Frame,{caption:`The approval form for a test run, showing the command and the sample input.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=d29c398d006c88b887ba86938bb5099e`,alt:`The workbench's approval form asking whether to test-run user__merged_prs once with the command gh pr list --state merged --search merged:>={{input.since}} --json number,title,mergedAt and the input since 2026-09-24, with run set to true.`,\"data-og-width\":`1044`,width:`1044`,\"data-og-height\":`720`,height:`720`,\"data-path\":`images/workbench/tool-try.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=280\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=3867f7a8d5ed2101c487881645efa53c 280w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=560\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=c49fee5bb829477929ed8e3acca94652 560w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=840\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=716a74cd8dcc37e920914b9247d34514 840w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=2a53dcbda4fd3882a6aa18d7259525c6 1100w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=225ce11d622006936402d96c3ab5a2b4 1650w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/tool-try.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=50b8a1986dfe5c4352b6887788aefd20 2500w`})}),_jsx(_components.p,{children:`The result shows in the pane:`}),_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:`[`})}),`\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:` \"mergedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-09T02:25:01Z\"`}),_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:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`147`}),_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:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"feat!: plans state how they finish with a required finish key…\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mergedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-08T19:34:56Z\"`}),_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:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`146`}),_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:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"feat!: workbench agents work on plans through the same artifact tools…\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:` …`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})})]}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Press `,_jsx(`kbd`,{children:`Ctrl`}),`+`,_jsx(`kbd`,{children:`S`}),`. graph writes the file to `,_jsx(_components.code,{children:`./.graph/tools/merged_prs.yaml`}),`, and the tool is in your catalog as `,_jsx(_components.code,{children:`user__merged_prs`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related guides`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Test a tool`,icon:`flask`,href:`/tools/guides/test-a-tool`,children:_jsx(_components.p,{children:`Run any tool directly and see what it returns.`})}),_jsx(Card,{title:`Tool file`,icon:`file-code`,href:`/tools/reference/tool-file`,children:_jsx(_components.p,{children:`Every field a tool file takes.`})}),_jsx(Card,{title:`Create an agent in the workbench`,icon:`wand-magic-sparkles`,href:`/agents/guides/create-in-workbench`,children:_jsx(_components.p,{children:`Draft an agent that calls your tool.`})}),_jsx(Card,{title:`Draft a plan in the workbench`,icon:`wand-magic-sparkles`,href:`/plans/guides/draft-in-workbench`,children:_jsx(_components.p,{children:`Draft a plan that uses your tool.`})})]})]})}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 a tool in the workbench","description":"Draft a tool with the tool drafter, test-run it, and save it.","keywords":["tool drafter","workbench","create tool"],"href":"/tools/guides/create-in-workbench"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Related guides","slug":"related-guides","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":".graph/tools/merged_prs.yaml","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"yaml\">\u003ccode language=\"yaml\" numberOfLines=\"21\">\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">name\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">merged_prs\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">description\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">Pull requests merged into this repository since a date, as number, title and merge time.\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">kind\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">exec\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">command\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">gh\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">args\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">pr\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">list\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">--state\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">merged\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">--search\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"merged:>={{input.since}}\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">--json\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> - \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">number,title,mergedAt\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">read_only\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">input_schema\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\"> type\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">object\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\"> required\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">since\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\"> properties\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\"> since\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">:\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\"> type\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">string\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\"> description\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">The earliest merge date, as YYYY-MM-DD\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"subdomain":"graph","siteName":"graph","title":"Create a tool in the workbench - graph","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T22:37:18.543Z","originalFileLocation":"tools/guides/create-in-workbench.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"description\" content=\"Draft a tool with the tool drafter, test-run it, and save it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"graph\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a tool in the workbench - graph\">\u003cmeta data-mint-head property=\"og:description\" content=\"Draft a tool with the tool drafter, test-run it, and save it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"graph\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://graph.mintlify.app/tools/guides/create-in-workbench\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a tool in the workbench - graph\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Draft a tool with the tool drafter, test-run it, and save it.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/graph/dDHy2CkfKrjxpFva/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"graph\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://graph.mintlify.app/tools/guides/create-in-workbench\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/guides/create-in-workbench.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://graph.mintlify.app/#organization\",\"name\":\"graph\",\"url\":\"https://graph.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://graph.mintlify.app#website\",\"name\":\"graph\",\"url\":\"https://graph.mintlify.app\",\"publisher\":{\"@id\":\"https://graph.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://graph.mintlify.app/tools/guides/create-in-workbench#webpage\",\"url\":\"https://graph.mintlify.app/tools/guides/create-in-workbench\",\"name\":\"Create a tool in the workbench\",\"description\":\"Draft a tool with the tool drafter, test-run it, and save it.\",\"dateModified\":\"2026-10-19T22:37:18.543Z\",\"isPartOf\":{\"@id\":\"https://graph.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://graph.mintlify.app/tools/guides/create-in-workbench#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://graph.mintlify.app/tools/guides/create-in-workbench#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://graph.mintlify.app/tools/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a tool in the workbench\",\"item\":\"https://graph.mintlify.app/tools/guides/create-in-workbench\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://graph.mintlify.app/tools/guides/create-in-workbench#article\",\"headline\":\"Create a tool in the workbench\",\"name\":\"Create a tool in the workbench\",\"description\":\"Draft a tool with the tool drafter, test-run it, and save it.\",\"url\":\"https://graph.mintlify.app/tools/guides/create-in-workbench\",\"mainEntityOfPage\":{\"@id\":\"https://graph.mintlify.app/tools/guides/create-in-workbench#webpage\"},\"dateModified\":\"2026-10-19T22:37:18.543Z\",\"keywords\":\"tool drafter, workbench, create tool\",\"publisher\":{\"@id\":\"https://graph.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://graph.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"graph\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"graph","nav":{"global":null,"pages":[{"title":"Introducing Graph","icon":"hand-wave","sidebarTitle":"Introduction","href":"/introduction"},{"title":"Quick start","icon":"rocket","href":"/quickstart"},{"group":"Getting started","icon":"person-ski-jumping","expanded":true,"pages":[{"title":"Installation","href":"/getting-started/installation"},{"title":"Core concepts","href":"/getting-started/concepts"},{"title":"Models and providers","href":"/getting-started/models"},{"title":"The workbench","href":"/getting-started/workbench"}]},{"group":"Agents","icon":"robot","expanded":true,"pages":[{"title":"Agents","sidebarTitle":"Overview","href":"/agents/overview"},{"group":"Guides","pages":[{"title":"Create an agent in the workbench","href":"/agents/guides/create-in-workbench"},{"title":"Talk to an agent","href":"/agents/guides/talk-to-an-agent"},{"title":"Optimize an agent with plans","href":"/agents/guides/optimize-with-plans"},{"title":"Build a multi-agent network","href":"/agents/guides/multi-agent-networks"},{"title":"Customize a built-in agent","href":"/agents/guides/customize-built-ins"},{"title":"Steer tool choice","href":"/agents/guides/steer-tool-choice"},{"title":"Manage threads","href":"/agents/guides/threads"}]},{"group":"Reference","pages":[{"title":"Agent file","playground":"none","href":"/agents/reference/agent-file"},{"group":"Built-in agents","root":{"title":"Built-in agents","href":"/agents/reference/built-in-agents"},"pages":[{"group":"Global","pages":[{"title":"chat","sidebarTitle":"chat","playground":"none","href":"/agents/reference/built-in/chat"},{"title":"agent_drafter","sidebarTitle":"agent_drafter","playground":"none","href":"/agents/reference/built-in/agent_drafter"},{"title":"tool_drafter","sidebarTitle":"tool_drafter","playground":"none","href":"/agents/reference/built-in/tool_drafter"}]},{"group":"Workbench","pages":[{"title":"front_desk (workbench)","sidebarTitle":"front_desk","playground":"none","href":"/agents/reference/built-in/workbench/front_desk"},{"title":"plan_drafter (workbench)","sidebarTitle":"plan_drafter","playground":"none","href":"/agents/reference/built-in/workbench/plan_drafter"},{"title":"plan_loader (workbench)","sidebarTitle":"plan_loader","playground":"none","href":"/agents/reference/built-in/workbench/plan_loader"},{"title":"plan_editor (workbench)","sidebarTitle":"plan_editor","playground":"none","href":"/agents/reference/built-in/workbench/plan_editor"},{"title":"agent_drafter (workbench)","sidebarTitle":"agent_drafter","playground":"none","href":"/agents/reference/built-in/workbench/agent_drafter"},{"title":"tool_drafter (workbench)","sidebarTitle":"tool_drafter","playground":"none","href":"/agents/reference/built-in/workbench/tool_drafter"}]}]}]}]},{"group":"Plans","icon":"list-radio","expanded":true,"pages":[{"title":"Plans","sidebarTitle":"Overview","href":"/plans/overview"},{"group":"Guides","pages":[{"title":"Draft a plan in the workbench","href":"/plans/guides/draft-in-workbench"},{"title":"Run a plan","href":"/plans/guides/run-a-plan"},{"title":"Debug a plan","href":"/plans/guides/debug-a-plan"},{"group":"Steps","pages":[{"title":"Stop early with exit gates","href":"/plans/guides/exit-gates"},{"title":"Branch with route","href":"/plans/guides/branching"},{"title":"Select items with filter","href":"/plans/guides/filter"},{"title":"Iterate with map and reduce","href":"/plans/guides/map-and-reduce"},{"title":"Delegate a step to an agent","href":"/plans/guides/agent-steps"},{"title":"Ask for input mid-run","href":"/plans/guides/ask-steps"}]},{"title":"Compose plans","href":"/plans/guides/compose-plans"},{"title":"Handle failures","href":"/plans/guides/handle-failures"}]},{"group":"Reference","pages":[{"title":"Plan file","playground":"none","href":"/plans/reference/plan-file"},{"title":"Conditions and bodies","href":"/plans/reference/conditions-and-bodies"},{"group":"Control steps","root":{"title":"Control steps","href":"/plans/reference/control-steps"},"pages":[{"title":"route","sidebarTitle":"route","playground":"none","href":"/plans/reference/steps/route"},{"title":"filter","sidebarTitle":"filter","playground":"none","href":"/plans/reference/steps/filter"},{"title":"map","sidebarTitle":"map","playground":"none","href":"/plans/reference/steps/map"},{"title":"reduce","sidebarTitle":"reduce","playground":"none","href":"/plans/reference/steps/reduce"},{"title":"exit","sidebarTitle":"exit","playground":"none","href":"/plans/reference/steps/exit"},{"title":"agent","sidebarTitle":"agent","playground":"none","href":"/plans/reference/steps/agent"},{"title":"ask","sidebarTitle":"ask","playground":"none","href":"/plans/reference/steps/ask"}]},{"group":"Built-in plans","root":{"title":"Built-in plans","href":"/plans/reference/built-in-plans"},"pages":[{"title":"compose_plan","sidebarTitle":"compose_plan","playground":"none","href":"/plans/reference/built-in/compose_plan"},{"title":"search_tools","sidebarTitle":"search_tools","playground":"none","href":"/plans/reference/built-in/search_tools"}]}]}]},{"group":"Tools","icon":"toolbox","expanded":true,"pages":[{"title":"Tools","sidebarTitle":"Overview","description":"Where tools come from, how they're named, and how to inspect any of them.","href":"/tools/overview"},{"group":"Guides","pages":[{"title":"Create a tool in the workbench","href":"/tools/guides/create-in-workbench"},{"title":"Test a tool","description":"Call a tool with input and read its result or error.","href":"/tools/guides/test-a-tool"},{"title":"Improve what graph knows about a tool","href":"/tools/guides/tool-shapes"}]},{"group":"Reference","pages":[{"group":"Tool file","root":{"title":"Tool file","playground":"none","href":"/tools/reference/tool-file"},"pages":[{"title":"exec tools","sidebarTitle":"kind: exec","playground":"none","href":"/tools/reference/tool-file/exec"},{"title":"prompt tools","sidebarTitle":"kind: prompt","playground":"none","href":"/tools/reference/tool-file/prompt"},{"title":"reshape tools","sidebarTitle":"kind: reshape","playground":"none","href":"/tools/reference/tool-file/reshape"},{"title":"decision tools","sidebarTitle":"kind: decision","playground":"none","href":"/tools/reference/tool-file/decision"}]},{"group":"Built-in tools","root":{"title":"Built-in tools","href":"/tools/reference/builtin-tools"},"pages":[{"title":"builtin__infer","sidebarTitle":"builtin__infer","playground":"none","href":"/tools/reference/builtin/infer"},{"title":"builtin__decide","sidebarTitle":"builtin__decide","playground":"none","href":"/tools/reference/builtin/decide"},{"title":"builtin__reshape","sidebarTitle":"builtin__reshape","playground":"none","href":"/tools/reference/builtin/reshape"}]},{"group":"Native tools","root":{"title":"Native tools","href":"/tools/reference/native-tools"},"pages":[{"group":"Plan authoring","pages":[{"title":"builtin__validate_plan","sidebarTitle":"builtin__validate_plan","playground":"none","href":"/tools/reference/native/validate_plan"},{"title":"builtin__check_plan","sidebarTitle":"builtin__check_plan","playground":"none","href":"/tools/reference/native/check_plan"},{"title":"builtin__compose_context","sidebarTitle":"builtin__compose_context","playground":"none","href":"/tools/reference/native/compose_context"},{"title":"builtin__question_form","sidebarTitle":"builtin__question_form","playground":"none","href":"/tools/reference/native/question_form"},{"title":"builtin__find_tools","sidebarTitle":"builtin__find_tools","playground":"none","href":"/tools/reference/native/find_tools"}]},{"group":"Tool search","pages":[{"title":"builtin__catalog_tools","sidebarTitle":"builtin__catalog_tools","playground":"none","href":"/tools/reference/native/catalog_tools"},{"title":"builtin__score_candidates","sidebarTitle":"builtin__score_candidates","playground":"none","href":"/tools/reference/native/score_candidates"},{"title":"builtin__describe_tools","sidebarTitle":"builtin__describe_tools","playground":"none","href":"/tools/reference/native/describe_tools"}]},{"group":"Drafting","pages":[{"title":"builtin__try_tool","sidebarTitle":"builtin__try_tool","playground":"none","href":"/tools/reference/native/try_tool"},{"title":"builtin__save_tool","sidebarTitle":"builtin__save_tool","playground":"none","href":"/tools/reference/native/save_tool"},{"title":"builtin__save_agent","sidebarTitle":"builtin__save_agent","playground":"none","href":"/tools/reference/native/save_agent"}]}]},{"group":"Workbench tools","root":{"title":"Workbench tools","href":"/tools/reference/workbench-tools"},"pages":[{"group":"Drafts","pages":[{"title":"workbench__list_artifacts","sidebarTitle":"workbench__list_artifacts","playground":"none","href":"/tools/reference/workbench/list_artifacts"},{"title":"workbench__show_artifact","sidebarTitle":"workbench__show_artifact","playground":"none","href":"/tools/reference/workbench/show_artifact"},{"title":"workbench__load_artifact","sidebarTitle":"workbench__load_artifact","playground":"none","href":"/tools/reference/workbench/load_artifact"},{"title":"workbench__set_artifact","sidebarTitle":"workbench__set_artifact","playground":"none","href":"/tools/reference/workbench/set_artifact"},{"title":"workbench__try_artifact","sidebarTitle":"workbench__try_artifact","playground":"none","href":"/tools/reference/workbench/try_artifact"},{"title":"workbench__save_artifact","sidebarTitle":"workbench__save_artifact","playground":"none","href":"/tools/reference/workbench/save_artifact"},{"title":"workbench__discard_artifact","sidebarTitle":"workbench__discard_artifact","playground":"none","href":"/tools/reference/workbench/discard_artifact"}]},{"group":"Plan edits","pages":[{"title":"workbench__update_metadata","sidebarTitle":"workbench__update_metadata","playground":"none","href":"/tools/reference/workbench/update_metadata"},{"title":"workbench__add_step","sidebarTitle":"workbench__add_step","playground":"none","href":"/tools/reference/workbench/add_step"},{"title":"workbench__update_step","sidebarTitle":"workbench__update_step","playground":"none","href":"/tools/reference/workbench/update_step"},{"title":"workbench__delete_step","sidebarTitle":"workbench__delete_step","playground":"none","href":"/tools/reference/workbench/delete_step"},{"title":"workbench__restore_draft","sidebarTitle":"workbench__restore_draft","playground":"none","href":"/tools/reference/workbench/restore_draft"}]},{"group":"Catalog","pages":[{"title":"workbench__describe_tool","sidebarTitle":"workbench__describe_tool","playground":"none","href":"/tools/reference/workbench/describe_tool"}]},{"group":"Files","pages":[{"title":"workbench__read_file","sidebarTitle":"workbench__read_file","playground":"none","href":"/tools/reference/workbench/read_file"},{"title":"workbench__glob","sidebarTitle":"workbench__glob","playground":"none","href":"/tools/reference/workbench/glob"},{"title":"workbench__grep","sidebarTitle":"workbench__grep","playground":"none","href":"/tools/reference/workbench/grep"}]}]}]}]},{"group":"Packs","icon":"box","expanded":true,"pages":[{"title":"Packs","sidebarTitle":"Overview","href":"/packs/overview"},{"group":"Guides","pages":[{"title":"Install and update packs","href":"/packs/guides/install-packs"},{"title":"Write a pack","href":"/packs/guides/write-a-pack"}]},{"group":"Reference","pages":[{"title":"pack.toml","playground":"none","href":"/packs/reference/pack-file"}]}]},{"group":"Integrating","icon":"plug","pages":[{"group":"MCP","root":{"title":"MCP","href":"/integrating/mcp/overview"},"pages":[{"group":"Guides","pages":[{"title":"Connect an MCP server","href":"/integrating/mcp/guides/connect-mcp-server"},{"title":"Serve plans over MCP","href":"/integrating/mcp/guides/serve-over-mcp"},{"title":"Filter and override a server's tools","href":"/integrating/mcp/guides/filter-and-override-tools"},{"title":"Test an MCP server","href":"/integrating/mcp/guides/test-an-mcp-server"}]},{"group":"Reference","pages":[{"group":"MCP server tools","root":{"title":"MCP server tools","href":"/integrating/mcp/reference/server-tools"},"pages":[{"title":"graph_plan_list","sidebarTitle":"graph_plan_list","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_list"},{"title":"graph_plan_show","sidebarTitle":"graph_plan_show","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_show"},{"title":"graph_plan_new","sidebarTitle":"graph_plan_new","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_new"},{"title":"graph_plan_draft","sidebarTitle":"graph_plan_draft","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_draft"},{"title":"graph_plan_set","sidebarTitle":"graph_plan_set","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_set"},{"title":"graph_plan_unset","sidebarTitle":"graph_plan_unset","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_unset"},{"title":"graph_plan_step_add","sidebarTitle":"graph_plan_step_add","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_add"},{"title":"graph_plan_step_update","sidebarTitle":"graph_plan_step_update","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_update"},{"title":"graph_plan_step_rename","sidebarTitle":"graph_plan_step_rename","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_rename"},{"title":"graph_plan_step_rm","sidebarTitle":"graph_plan_step_rm","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_rm"},{"title":"graph_plan_validate","sidebarTitle":"graph_plan_validate","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_validate"},{"title":"graph_tools_list","sidebarTitle":"graph_tools_list","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_tools_list"},{"title":"graph_tools_show","sidebarTitle":"graph_tools_show","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_tools_show"},{"title":"graph_tools_test","sidebarTitle":"graph_tools_test","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_tools_test"}]}]}]},{"group":"Observability","pages":[{"title":"OpenTelemetry","href":"/integrating/observability/opentelemetry"},{"title":"Stream run events","href":"/integrating/observability/run-events"}]}]},{"group":"Reference","icon":"book","pages":[{"group":"CLI","root":{"title":"CLI reference","href":"/reference/cli/overview"},"pages":[{"title":"graph ask","sidebarTitle":"graph ask","playground":"none","href":"/reference/cli/ask"},{"title":"graph chat","sidebarTitle":"graph chat","playground":"none","href":"/reference/cli/chat"},{"group":"graph plan","root":{"title":"graph plan","sidebarTitle":"graph plan","playground":"none","href":"/reference/cli/plan"},"pages":[{"title":"graph plan list","sidebarTitle":"list","playground":"none","href":"/reference/cli/plan/list"},{"title":"graph plan show","sidebarTitle":"show","playground":"none","href":"/reference/cli/plan/show"},{"title":"graph plan validate","sidebarTitle":"validate","playground":"none","href":"/reference/cli/plan/validate"},{"title":"graph plan migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/plan/migrate"},{"title":"graph plan run","sidebarTitle":"run","playground":"none","href":"/reference/cli/plan/run"},{"title":"graph plan new","sidebarTitle":"new","playground":"none","href":"/reference/cli/plan/new"},{"title":"graph plan draft","sidebarTitle":"draft","playground":"none","href":"/reference/cli/plan/draft"},{"title":"graph plan set","sidebarTitle":"set","playground":"none","href":"/reference/cli/plan/set"},{"title":"graph plan unset","sidebarTitle":"unset","playground":"none","href":"/reference/cli/plan/unset"},{"group":"graph plan step","root":{"title":"graph plan step","sidebarTitle":"graph plan step","playground":"none","href":"/reference/cli/plan/step"},"pages":[{"title":"graph plan step add","sidebarTitle":"add","playground":"none","href":"/reference/cli/plan/step/add"},{"title":"graph plan step update","sidebarTitle":"update","playground":"none","href":"/reference/cli/plan/step/update"},{"title":"graph plan step rename","sidebarTitle":"rename","playground":"none","href":"/reference/cli/plan/step/rename"},{"title":"graph plan step unset","sidebarTitle":"unset","playground":"none","href":"/reference/cli/plan/step/unset"},{"title":"graph plan step rm","sidebarTitle":"rm","playground":"none","href":"/reference/cli/plan/step/rm"}]}]},{"group":"graph tool","root":{"title":"graph tool","sidebarTitle":"graph tool","playground":"none","href":"/reference/cli/tool"},"pages":[{"title":"graph tool list","sidebarTitle":"list","playground":"none","href":"/reference/cli/tool/list"},{"title":"graph tool show","sidebarTitle":"show","playground":"none","href":"/reference/cli/tool/show"},{"title":"graph tool test","sidebarTitle":"test","playground":"none","href":"/reference/cli/tool/test"},{"title":"graph tool migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/tool/migrate"}]},{"group":"graph agent","root":{"title":"graph agent","sidebarTitle":"graph agent","playground":"none","href":"/reference/cli/agent"},"pages":[{"title":"graph agent list","sidebarTitle":"list","playground":"none","href":"/reference/cli/agent/list"},{"title":"graph agent show","sidebarTitle":"show","playground":"none","href":"/reference/cli/agent/show"},{"title":"graph agent validate","sidebarTitle":"validate","playground":"none","href":"/reference/cli/agent/validate"},{"title":"graph agent migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/agent/migrate"}]},{"group":"graph thread","root":{"title":"graph thread","sidebarTitle":"graph thread","playground":"none","href":"/reference/cli/thread"},"pages":[{"title":"graph thread list","sidebarTitle":"list","playground":"none","href":"/reference/cli/thread/list"},{"title":"graph thread show","sidebarTitle":"show","playground":"none","href":"/reference/cli/thread/show"},{"title":"graph thread rm","sidebarTitle":"rm","playground":"none","href":"/reference/cli/thread/rm"}]},{"group":"graph mcp","root":{"title":"graph mcp","sidebarTitle":"graph mcp","playground":"none","href":"/reference/cli/mcp"},"pages":[{"title":"graph mcp list","sidebarTitle":"list","playground":"none","href":"/reference/cli/mcp/list"},{"title":"graph mcp tools","sidebarTitle":"tools","playground":"none","href":"/reference/cli/mcp/tools"},{"title":"graph mcp test","sidebarTitle":"test","playground":"none","href":"/reference/cli/mcp/test"},{"title":"graph mcp serve","sidebarTitle":"serve","playground":"none","href":"/reference/cli/mcp/serve"},{"title":"graph mcp probe","sidebarTitle":"probe","playground":"none","href":"/reference/cli/mcp/probe"}]},{"group":"graph shape","root":{"title":"graph shape","sidebarTitle":"graph shape","playground":"none","href":"/reference/cli/shape"},"pages":[{"title":"graph shape list","sidebarTitle":"list","playground":"none","href":"/reference/cli/shape/list"},{"title":"graph shape show","sidebarTitle":"show","playground":"none","href":"/reference/cli/shape/show"}]},{"group":"graph config","root":{"title":"graph config","sidebarTitle":"graph config","playground":"none","href":"/reference/cli/config"},"pages":[{"title":"graph config show","sidebarTitle":"show","playground":"none","href":"/reference/cli/config/show"},{"title":"graph config init","sidebarTitle":"init","playground":"none","href":"/reference/cli/config/init"},{"title":"graph config path","sidebarTitle":"path","playground":"none","href":"/reference/cli/config/path"},{"title":"graph config check","sidebarTitle":"check","playground":"none","href":"/reference/cli/config/check"},{"title":"graph config migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/config/migrate"}]},{"group":"graph pack","root":{"title":"graph pack","sidebarTitle":"graph pack","playground":"none","href":"/reference/cli/pack"},"pages":[{"title":"graph pack add","sidebarTitle":"add","playground":"none","href":"/reference/cli/pack/add"},{"title":"graph pack list","sidebarTitle":"list","playground":"none","href":"/reference/cli/pack/list"},{"title":"graph pack update","sidebarTitle":"update","playground":"none","href":"/reference/cli/pack/update"},{"title":"graph pack remove","sidebarTitle":"remove","playground":"none","href":"/reference/cli/pack/remove"},{"title":"graph pack new","sidebarTitle":"new","playground":"none","href":"/reference/cli/pack/new"},{"title":"graph pack check","sidebarTitle":"check","playground":"none","href":"/reference/cli/pack/check"},{"title":"graph pack run","sidebarTitle":"run","playground":"none","href":"/reference/cli/pack/run"},{"title":"graph pack test","sidebarTitle":"test","playground":"none","href":"/reference/cli/pack/test"},{"title":"graph pack release","sidebarTitle":"release","playground":"none","href":"/reference/cli/pack/release"}]},{"group":"graph workbench","root":{"title":"graph workbench","sidebarTitle":"graph workbench","playground":"none","href":"/reference/cli/workbench"},"pages":[{"title":"graph workbench plan","sidebarTitle":"plan","playground":"none","href":"/reference/cli/workbench/plan"},{"title":"graph workbench agent","sidebarTitle":"agent","playground":"none","href":"/reference/cli/workbench/agent"},{"title":"graph workbench tool","sidebarTitle":"tool","playground":"none","href":"/reference/cli/workbench/tool"}]},{"title":"graph version","sidebarTitle":"graph version","playground":"none","href":"/reference/cli/version"},{"title":"Error handling","href":"/reference/cli/error-handling"}]},{"title":"config.toml","playground":"none","href":"/reference/configuration"},{"title":"Environment variables","playground":"none","href":"/reference/environment-variables"},{"title":"Template language","href":"/reference/template-language"},{"title":"File versions","href":"/reference/file-versions"},{"title":"Data directory","href":"/reference/data-directory"},{"title":"Glossary","href":"/reference/glossary"}]},{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"title":"Create a tool in the workbench - graph","buildId":"dpl_CJQjyFMo3m7wZruKi1248oJzrnYG","deploymentId":"dpl_CJQjyFMo3m7wZruKi1248oJzrnYG","dynamics":["2b790eda92","07c022d89b","a74be98ba7"],"chunks":["ApiExamples-5GAkZHDS.js","utils-2Sl_B7yQ.js","_Uint8Array-JMZMJLdF.js","isArray-CXeVWmfx.js","isObject-Bw72BMo0.js","cloneDeep-CsK1MRZH.js","utils-9Mu3PD8i.js","toString-Ci69GPsS.js","snippetPresets-B6fp__Qr.js","style-to-object-8s5bpEGF.js","v4-DIgz8zy6.js","isEqual-XZWsFdP7.js","usePlaygroundInputsStore-POYu3hGq.js","shallow-CV8aXWrC.js","getApiPlaygroundDisplay-Dg2gVsmo.js","ChevronDownIcon-DomGC_BK.js","CodeSnippet-BG0ppT83.js","CodeSnippets-DVMQ5VYD.js","Frame-DPQvot1W.js","DynamicMarkdown-XfgpN2Wi.js","zoom-image-lightbox-6J4uLOST.js","PlusIcon-Bs8LLFlB.js","lightbox-handle-r17bVUz3.js"]}
