Agentek AI SDK

A toolkit for integrating Agentek blockchain tools with the Vercel AI SDK. This package provides adapters that make Agentek's blockchain tools available as AI function calling tools.

✨ Features

• Vercel AI SDK Integration: Seamless integration with Vercel's AI SDK
• Tool Conversion: Automatically converts Agentek tools to AI SDK compatible format
• Unified Toolkit: Bundle multiple tools into a single toolkit
• Type Safety: Full TypeScript support with strict typing
• Compatibility: Works with OpenRouter, Anthropic, OpenAI, and other LLM providers

🚀 Installation

# npm
npm install @agentek/ai-sdk @agentek/tools

# pnpm
pnpm add @agentek/ai-sdk @agentek/tools

# yarn
yarn add @agentek/ai-sdk @agentek/tools

📋 Requirements

• Node.js >= 18.17.0 (Required for proper fetch API support)
• @agentek/tools as a peer dependency
• Vercel's ai package

🔧 Usage

Basic Usage with AI SDK and OpenRouter

import { http } from "viem";
import { mainnet } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";
import { createOpenRouter } from "@openrouter/ai-sdk-provider";
import { CoreMessage, generateText } from "ai";
import AgentekToolkit from "@agentek/ai-sdk/toolkit";
import { erc20Tools } from "@agentek/tools/erc20";
import { ensTools } from "@agentek/tools/ens";

// Set up account
const account = privateKeyToAccount(process.env.PRIVATE_KEY);

// Initialize OpenRouter
const openrouter = createOpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY,
});

// Create the toolkit with your tools
const toolkit = new AgentekToolkit({
  transports: [http()],
  chains: [mainnet],
  accountOrAddress: account,
  tools: [
    ...erc20Tools(),
    ...ensTools(),
    // Add more tools as needed
  ],
});

// Get tools in AI SDK format
const tools = toolkit.getTools();

// Set up user query
const messages = [
  {
    role: "user",
    content: "What's the ETH balance of vitalik.eth?",
  },
] as CoreMessage[];

// Generate response with AI using tools
const response = await generateText({
  model: openrouter("anthropic/claude-3-opus"),
  system: `Address: ${account.address}`,
  messages,
  maxSteps: 5, // Maximum number of tool calls
  tools: tools,
  experimental_activeTools: Object.keys(tools),
});

// Process response
console.log(response.response.messages);

Creating a Toolkit with Various Tool Categories

import { http } from "viem";
import { mainnet, base } from "viem/chains";
import AgentekToolkit from "@agentek/ai-sdk/toolkit";
import { erc20Tools } from "@agentek/tools/erc20";
import { webTools } from "@agentek/tools/web";
import { naniTools } from "@agentek/tools/nani";
import { fearGreedIndexTools } from "@agentek/tools/feargreed";

// Create toolkit with multiple transports for different chains
const toolkit = new AgentekToolkit({
  transports: [http(), http()],
  chains: [mainnet, base],
  accountOrAddress: account,
  tools: [
    ...erc20Tools(),
    ...webTools(),
    ...naniTools(),
    ...fearGreedIndexTools(),
    // Add API key dependent tools conditionally
    ...(process.env.ZEROX_API_KEY ? swapTools({ zeroxApiKey: process.env.ZEROX_API_KEY }) : []),
  ],
});

🏗️ Implementation Notes

• The toolkit automatically converts Zod parameter schemas into AI SDK tool definitions
• Error handling is built-in with descriptive error messages
• Each tool uses the Agentek client for blockchain interaction

📚 Documentation

For more detailed documentation and examples, see the examples directory in the repository.

📄 License

AGPL-3.0