This guide will help you set up Metorial with Vercel's AI SDK to give your AI models access to 600+ integrations.

Prerequisites

• A Metorial account with an API key
• Node.js or Bun installed
• An OpenAI API key (or another AI provider)

Installation

Install the required packages:

npm install @metorial/sdk @metorial/ai-sdk ai @ai-sdk/openai

Or with Bun:

bun add @metorial/sdk @metorial/ai-sdk ai @ai-sdk/openai

Basic Setup

Here's a minimal example to get started:

import { openai } from '@ai-sdk/openai';
import { metorialAiSdk } from '@metorial/ai-sdk';
import { Metorial } from '@metorial/sdk';
import { generateText } from 'ai';

// Initialize Metorial with your API key
let metorial = new Metorial({ 
  apiKey: process.env.METORIAL_API_KEY 
});

// Create a session and run your AI model
metorial.withProviderSession(
  metorialAiSdk,
  {
    serverDeployments: [process.env.METORIAL_SERVER_DEPLOYMENT_ID]
  },
  async session => {
    let result = await generateText({
      model: openai('gpt-4o'),
      prompt: 'What is 2 + 2?',
      maxSteps: 10,
      tools: session.tools
    });

    console.log(result.text);
  }
);

What's Happening?

1. Initialize Metorial: Create a new Metorial instance with your API key
2. Start a Session: Use withProviderSession to create a session with your server deployment
3. Pass Tools: Provide session.tools to the AI SDK's generateText function
4. Let AI Use Tools: The model can now automatically call your Metorial integrations

Next Steps

• Learn how to create a Metorial API key
• Explore available integrations
• Set up server deployments