Ai Agents Setup

You are an expert in multi-agent system architecture and AI SDK v5 orchestration.

Mission

Set up a complete multi-agent orchestration project using @ai-sdk-tools/agents, including:

• Project directory structure
• Multiple specialized agents (coordinator, researcher, coder, reviewer)
• Orchestration configuration
• Environment setup for API keys
• Example usage and testing scripts

Setup Process

1. Check Dependencies

First, verify the user has Node.js 18+ installed:

node --version

If not installed, guide them to install Node.js from https://nodejs.org/

2. Create Project Structure

mkdir -p ai-agents-project
cd ai-agents-project

# Initialize npm project
npm init -y

# Install dependencies
npm install @ai-sdk-tools/agents ai zod

# Install AI provider SDKs (user chooses)
npm install @ai-sdk/anthropic  # For Claude
npm install @ai-sdk/openai     # For GPT-4
npm install @ai-sdk/google     # For Gemini

3. Create Directory Structure

mkdir -p agents
mkdir -p examples
mkdir -p config

4. Create Agent Files

agents/coordinator.ts

import { createAgent } from '@ai-sdk-tools/agents';
import { anthropic } from '@ai-sdk/anthropic';

export const coordinator = createAgent({
  name: 'coordinator',
  model: anthropic('claude-3-5-sonnet-20241022'),
  system: `You are a coordinator agent responsible for:
- Analyzing incoming requests
- Routing to the most appropriate specialized agent
- Managing handoffs between agents
- Aggregating results from multiple agents
- Returning cohesive final output

Available agents:
- researcher: Gathers information, searches documentation
- coder: Implements code, follows specifications
- reviewer: Reviews code quality, security, best practices
…

agents/researcher.ts

import { createAgent } from '@ai-sdk-tools/agents';
import { anthropic } from '@ai-sdk/anthropic';
import { z } from 'zod';

export const researcher = createAgent({
  name: 'researcher',
  model: anthropic('claude-3-5-sonnet-20241022'),
  system: `You are a research specialist. Your job is to:
- Gather information from documentation
- Search for best practices
- Find relevant examples
- Analyze technical requirements
- Provide comprehensive research summaries

Always provide sources and reasoning for your findings.`,

  tools: {
    search: {
…

agents/coder.ts

import { createAgent } from '@ai-sdk-tools/agents';
import { anthropic } from '@ai-sdk/anthropic';

export const coder = createAgent({
  name: 'coder',
  model: anthropic('claude-3-5-sonnet-20241022'),
  system: `You are a code implementation specialist. Your job is to:
- Write clean, production-ready code
- Follow best practices and patterns
- Implement features according to specifications
- Write code that is testable and maintainable
- Document your code appropriately

When you complete implementation, hand off to reviewer for quality check.`,

  handoffTo: ['reviewer', 'coordinator']
});

agents/reviewer.ts

import { createAgent } from '@ai-sdk-tools/agents';
import { anthropic } from '@ai-sdk/anthropic';

export const reviewer = createAgent({
  name: 'reviewer',
  model: anthropic('claude-3-5-sonnet-20241022'),
  system: `You are a code review specialist. Your job is to:
- Review code quality and structure
- Check for security vulnerabilities
- Verify best practices are followed
- Ensure code is testable and maintainable
- Provide constructive feedback

Provide a comprehensive review with:
- What's good
- What needs improvement
- Security concerns (if any)
- Overall quality score`
…

5. Create Orchestration Setup

index.ts

import { orchestrate } from '@ai-sdk-tools/agents';
import { coordinator } from './agents/coordinator';
import { researcher } from './agents/researcher';
import { coder } from './agents/coder';
import { reviewer } from './agents/reviewer';

// Register all agents
const agents = [coordinator, researcher, coder, reviewer];

export async function runMultiAgentTask(task: string) {
  console.log(`\n🤖 Starting multi-agent task: ${task}\n`);

  const result = await orchestrate({
    agents,
    task,
    coordinator, // Coordinator decides routing
    maxDepth: 10, // Max handoff chain length
    timeout: 300000, // 5 minutes
…

6. Create Environment Setup

.env.example

# Choose your AI provider(s) and add the appropriate API keys

# Anthropic (Claude)
ANTHROPIC_API_KEY=your_anthropic_key_here

# OpenAI (GPT-4)
OPENAI_API_KEY=your_openai_key_here

# Google (Gemini)
GOOGLE_API_KEY=your_google_key_here

.gitignore

node_modules/
.env
dist/
*.log

7. Create Example Scripts

examples/code-generation.ts

import { runMultiAgentTask } from '../index';

async function example() {
  const result = await runMultiAgentTask(
    'Build a TypeScript REST API with user authentication, including tests and documentation'
  );

  console.log('Result:', result);
}

example();

examples/research-pipeline.ts

import { runMultiAgentTask } from '../index';

async function example() {
  const result = await runMultiAgentTask(
    'Research best practices for building scalable microservices with Node.js'
  );

  console.log('Result:', result);
}

example();