zod-to-openai-tool

Easily create tools from zod schemas to use with OpenAI Assistants and Chat Completions.

Usage

1import { t, createTools } from "zod-to-openai-tool";
2
3const { tools, processAssistantActions } = createTools({
4  getWeather: t
5    .input(z.object({ city: z.string() }))
6    .describe("Get the weather in a city")
7    .run(async ({ city }) => {
8      const weatherData = await getWeather(city);
9      return { weather: weatherData };
10    }),
11});
12
13const assistant = await openai.beta.assistants.create({
14  tools,
15  // ...
16});
17
18// Then, when the assistant uses the tools and responds with `requires_action`:
19const actions = run.required_action.submit_tool_outputs.tool_calls;
20const tool_outputs = processAssistantActions(actions);
21await openai.beta.threads.runs.submitToolOutputs(thread.id, run.id, {
22  tool_outputs,
23});

See the examples folder and the JSDocs for more examples and information.

See homeassistant-chatbot-zod for another more useful example :)

This package exports the following functions:

• t - Used to create a new tool
• createTools(tools) - Used to convert tools to the openai format (and give them a name)
• combineTools(...tools) - Used to combine multiple tools into one (including Code Interpreter and File Search)

Installation

npm install zod-to-openai-tool

Tools

A tool is created using the t object. They can then have the following properties added:

• input - The input to the function (optional). This needs to be an object (z.object({}))
• describe - A description of the function (optional)
• run - The function to run using the input (required)

You'll need to define the input first in order for it to be inferred all the way when using the function.