Use PartFinder with the AI SDK by Vercel

This page gives a model in the AI SDK by Vercel the PartFinder API as tools. generateText runs each tool call and sends the result back until the model answers.

Install

npm install ai
export AI_GATEWAY_API_KEY="..."
export PARTFINDER_API_KEY="ak_..."

Save partfinder-tools.mjs next to your code. It builds the tools from the OpenAPI document and makes each call with the key from PARTFINDER_API_KEY.

Give the model the tools

agent.mjs

import { generateText, tool, jsonSchema, isStepCount } from "ai";
import { operations, callTool } from "./partfinder-tools.mjs";

const tools = Object.fromEntries(
  operations.map((op) => [
    op.name,
    tool({
      description: op.description,
      inputSchema: jsonSchema(op.parameters),
      execute: (input) => callTool(op.name, input),
    }),
  ]),
);

const result = await generateText({
  model: "anthropic/claude-sonnet-5.5",
  tools,
  stopWhen: isStepCount(5),
  prompt: "Is my PartFinder API key working?",
});

console.log(result.text);

jsonSchema wraps each operation’s JSON Schema for inputSchema. stopWhen: isStepCount(5) lets the model make tool calls for up to five steps. A model id such as anthropic/claude-sonnet-5.5 runs through the AI Gateway, which reads AI_GATEWAY_API_KEY. Any other gateway the AI SDK supports works the same way: only the model line changes.

Jobs and refusals

searchParts, compareParts and analyzeBom start a job. callTool waits for the job and returns the finished result, so the model does not need to poll. A refused call returns the API’s JSON with its error code and summary, and the model reads it like any other result. See AI agent integration for the rest of the rules.

Get Started

Core Concepts

Guides

Integrations

Use PartFinder with the AI SDK by Vercel

Install

Give the model the tools

Jobs and refusals

​Install

​Give the model the tools

​Jobs and refusals

Install

Give the model the tools

Jobs and refusals