Pass meta-tools to generateText with maxSteps
+ +
+
+ const
+ result =
+ await
+ generateText
+ {'({'}
+ {'\n'}
+ {' '}
+ model
+ :
+ openai
+ (
+ 'gpt-4o'
+ ),
+ {'\n'}
+ {' '}
+ tools
+ {': {'}
+ {'\n'}
+ {' '}
+ search
+ :
+ searchTpmjsToolsTool
+ ,
+ {'\n'}
+ {' '}
+ execute
+ :
+ registryExecuteTool
+ ,
+ {'\n'}
+ {' },'}
+ {'\n'}
+ {' '}
+ maxSteps
+ :
+ 10
+ ,
+ {' // Allow multiple tool calls'}
+ {'\n'}
+ {' '}
+ system
+ :
+ `You are an assistant that can find and use
+ {'\n'}
+
+ {' '}
+ tools from the TPMJS registry. First search for
+
+ {'\n'}
+ relevant tools, then execute them.`
+ ,
+ {'\n'}
+ {' '}
+ prompt
+ : userRequest,
+ {'\n'}
+ {'});'}
+
+
+ + Key: maxSteps allows the agent to search, then + execute, then reason about results +
+Complete working example
+ +
+
+ git clone
+ github.com/tpmjs/agent-example
+ {'\n'}
+ cd
+ agent-example
+ {'\n'}
+ npm
+ install
+ {'\n'}
+ npm
+ run dev
+
+
+ What happens when the agent runs
+ +Add the TPMJS meta-tools to your project
+ +
+
+ npm
+
+ {' '}
+ install @tpmjs/search-registry @tpmjs/registry-execute
+
+
+
+
+
+ import
+ {' { searchTpmjsToolsTool } '}
+ from
+ {'\n'}
+ '@tpmjs/search-registry'
+ ;
+ {'\n'}
+ import
+ {' { registryExecuteTool } '}
+ from
+ {'\n'}
+ '@tpmjs/registry-execute'
+ ;
+ {'\n'}
+ import
+ {' { generateText } '}
+ from
+ 'ai'
+ ;
+
+
+ + An agent that can handle any request by finding the right tools +
+ ++ "Convert this markdown to a formatted blog post and generate a summary" +
+Your tool is now discoverable by AI agents
+ +Complete code example:
+github.com/tpmjs/example-tool
+ Add the tpmjs-tool keyword for discovery
+ +
+
+ {'{'}
+ {'\n'}
+ {' '}
+ "name"
+ :
+ "my-ai-tool"
+ ,
+ {'\n'}
+ {' '}
+ "version"
+ :
+ "1.0.0"
+ ,
+ {'\n'}
+ {' '}
+ "keywords"
+ : [
+ {'\n'}
+ {' '}
+ "tpmjs-tool"
+ {' โ Required for discovery'}
+ {'\n'}
+ {' ],'}]
+ {'\n'}
+ {' '}
+ "main"
+ :
+ "dist/index.js"
+ ,
+ {'\n'}
+ {' '}
+ "types"
+ :
+ "dist/index.d.ts"
+ ,
+ {'\n'}
+ {' '}
+ "exports"
+ {': {'}
+ {'\n'}
+ {' '}
+ "."
+ :
+ "./dist/index.js"
+ {'\n'}
+ {' }'}
+ {'\n'}
+ {'}'}
+
+
+
+ Key: The{' '}
+ tpmjs-tool keyword triggers
+ automatic indexing
+
Create a new npm package
+ +
+
+ # Create directory
+ {'\n'}
+ mkdir
+ my-ai-tool
+ {'\n'}
+ cd
+ my-ai-tool
+ {'\n\n'}
+ # Initialize package
+ {'\n'}
+ npm
+ init -y
+ {'\n\n'}
+ # Install dependencies
+ {'\n'}
+ npm
+ install ai zod
+
+
+ Build and publish your tool
+ +
+
+ # Build TypeScript
+ {'\n'}
+ npm
+ run build
+ {'\n\n'}
+ # Publish to npm
+ {'\n'}
+ npm
+ publish
+
+
+ + Define schema, description, and execute function +
+ +
+
+ import
+ {' { tool } '}
+ from
+ {" 'ai'"}
+ ;
+ {'\n'}
+ import
+ {' { z } '}
+ from
+ {" 'zod'"}
+ ;
+ {'\n\n'}
+ export const
+ greetingTool
+ =
+ tool
+ {'({'}
+ {'\n'}
+ {' '}
+ description
+ :
+ 'Generate a greeting'
+ ,
+ {'\n'}
+ {' '}
+ parameters
+ : z.
+ object
+ {'({'}
+ {'\n'}
+ {' '}
+ name
+ : z.
+ string
+ ().
+ describe
+ (
+ 'Name'
+ ),
+ {'\n'}
+ {' }'}),
+ {'\n'}
+ {' '}
+ execute
+ :
+ async
+ {' ({ name }) => {'}
+ {'\n'}
+ {' '}
+ return
+
+ `Hello,
+ {'${'}
+ name
+ {'}'}
+ !`
+ ;
+ {'\n'}
+ {' },'}
+ {'\n'}
+ {'});'}
+
+
+ + The form is auto-generated from the tool's schema +
+ +Browse or search the registry
+ +Click "Try it" on any tool page
+ ++ Every tool page has a "Try it" button that opens the playground +
+Why the playground is useful
+ +Tool executes in a secure sandbox
+ +
+ {JSON.stringify(
+ {
+ text: 'Hello world, I love coding!',
+ style: 'expressive',
+ },
+ null,
+ 2
+ )}
+
+
+ {JSON.stringify(
+ {
+ result: '๐๐, ๐๐ป!',
+ emoji_count: 4,
+ },
+ null,
+ 2
+ )}
+
+