CORE CONCEPTS

Agent Types

The SDK includes 8 pre-built agent templates optimized for common business use cases. Each template provides sensible defaults that you can customize.

Customer Support

AGT-001

Handle inbound support requests with context-aware responses. Integrates with helpdesk systems, order databases, and knowledge bases to resolve tickets autonomously.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.3

Max Tokens: 1024

System Prompt

You are a customer support agent. Help customers with orders, returns, billing, and product questions. Be professional, concise, and empathetic. Escalate to a human for legal issues or refunds over $500.

Code Example

const agent = await client.agents.create({ name: "Support Agent", template: "customer-support", model: "claude-sonnet-4-20250514", tools: [lookupOrder, createTicket, initiateReturn], });

Sales Assistant

AGT-002

Qualify leads through intelligent conversation. Score prospects, schedule demos, and hand off warm leads to your sales team with full context.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.5

Max Tokens: 1024

System Prompt

You are a sales assistant for a B2B SaaS company. Qualify leads by asking about their company size, current solutions, budget, and timeline. Score leads as hot, warm, or cold. Schedule demos for hot leads.

Code Example

const agent = await client.agents.create({ name: "Sales Bot", template: "sales-assistant", model: "claude-sonnet-4-20250514", tools: [qualifyLead, scheduleDemo, updateCRM], });

Data Processor

AGT-003

Extract structured data from unstructured inputs like emails, PDFs, invoices, and forms. Validate, transform, and route data to downstream systems.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.1

Max Tokens: 2048

System Prompt

You are a data extraction agent. Parse the input document and extract structured fields. Always validate extracted data against the schema. Flag any ambiguous or missing fields.

Code Example

const agent = await client.agents.create({ name: "Data Extractor", template: "data-processor", model: "claude-sonnet-4-20250514", tools: [parseDocument, validateSchema, routeData], });

Content Generator

AGT-004

Generate blog posts, product descriptions, social media content, and marketing copy. Maintains brand voice consistency across all outputs.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.7

Max Tokens: 4096

System Prompt

You are a content creation agent. Write engaging, SEO-optimized content in the brand's voice. Follow the style guide provided. Include relevant keywords naturally. Target the specified audience and word count.

Code Example

const agent = await client.agents.create({ name: "Content Writer", template: "content-generator", model: "claude-sonnet-4-20250514", tools: [searchKeywords, checkPlagiarism, publishDraft], });

Workflow Automator

AGT-005

Orchestrate multi-step business processes with conditional logic, branching, and error handling. Connects to any API or service through tools.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.2

Max Tokens: 2048

System Prompt

You are a workflow automation agent. Execute the specified workflow step by step. Handle errors gracefully and retry failed steps up to 3 times. Log all actions for audit purposes.

Code Example

const agent = await client.agents.create({ name: "Workflow Runner", template: "workflow-automator", model: "claude-sonnet-4-20250514", tools: [callAPI, sendEmail, updateDatabase, notifySlack], });

Research Analyst

AGT-006

Synthesize information from multiple sources into structured reports. Compares data points, identifies trends, and generates actionable insights.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.4

Max Tokens: 4096

System Prompt

You are a research analyst agent. Gather information from the provided sources, cross-reference data points, and synthesize findings into a structured report. Include citations, confidence levels, and recommendations.

Code Example

const agent = await client.agents.create({ name: "Research Bot", template: "research-analyst", model: "claude-sonnet-4-20250514", tools: [searchWeb, queryDatabase, generateChart], });

Code Assistant

AGT-007

Generate, review, and refactor code with full repository awareness. Writes tests, explains complex logic, and suggests architectural improvements.

Recommended Configuration

Model: claude-sonnet-4-20250514

Temperature: 0.2

Max Tokens: 4096

System Prompt

You are a code assistant. Help developers write, review, and debug code. Follow the project's coding standards. Always include error handling and write tests for new functionality. Explain your reasoning.

Code Example

const agent = await client.agents.create({ name: "Code Helper", template: "code-assistant", model: "claude-sonnet-4-20250514", tools: [readFile, writeFile, runTests, searchCode], });

Custom

AGT-008

Build any agent type with your own system prompts, tool definitions, and business logic. Full control over every configuration parameter.

Recommended Configuration

Model: any

Temperature: varies

Max Tokens: varies

System Prompt

Define your own system prompt tailored to your exact use case. No template constraints — full flexibility.

Code Example

const agent = await client.agents.create({ name: "My Custom Agent", model: "claude-sonnet-4-20250514", systemPrompt: "Your custom instructions here...", tools: [/* your tools */], parameters: { temperature: 0.5, maxTokens: 2048 }, });