AI Agents Overview

AI Agents Overview

AI Agents allow you to automate customer conversations using large language models. When a customer sends a message to your sender, the agent can respond intelligently, answer questions from your knowledge base, and execute actions via webhooks.

When to Use AI Agents

AI Agents are ideal for:

Supported Providers

Configure your agent with any of these LLM providers:

Quick Start

Here's how to create an AI agent for a sender:

TypeScriptcURLCopy
import Zavudev from "@zavudev/sdk";

const zavu = new Zavudev({
  apiKey: process.env["ZAVUDEV_API_KEY"],
});

// Create an agent for your sender
const { agent } = await zavu.senders.agent.create("sender_abc123", {
  name: "Acme Support",
  provider: "openai",
  model: "gpt-4o-mini",
  systemPrompt: `You are a helpful customer support agent for Acme Corp.
Be friendly and concise. If you don't know the answer, say so.
For billing questions, ask the customer to email billing@acme.com.`,
  temperature: 0.7,
  contextWindowMessages: 10,
  triggerOnChannels: ["sms", "whatsapp"],
});

console.log("Agent created:", agent.id);

The agent is created disabled. Switch it on with PATCH /v1/senders/{senderId}/agent and {"enabled": true} once it is configured; see Setup.

Agent Architecture

When a message arrives, the agent processes it through this flow:

CodeCopy
                    Inbound Message
                          |
                          v
                  +---------------+
                  | Agent Enabled?|
                  +---------------+
                    |           |
                   No          Yes
                    |           |
                    v           v
              +---------+  +-----------------+
              | Webhook |  | Check Flow State|
              |  Only   |  +-----------------+
              +---------+       |         |
                          Has Active   No Active
                             Flow        Flow
                               |           |
                               v           v
                         +---------+  +-----------+
                         | Execute |  | Match Flow|
                         |   Step  |  |  Triggers |
                         +---------+  +-----------+
                               |           |
                               |      No Match
                               |           |
                               v           v
                         +---------+  +-----------+
                         |  Send   |  | Query KB  |
                         |Response |  | + LLM Call|
                         +---------+  +-----------+
                                           |
                                           v
                                     +-----------+
                                     |   Send    |
                                     |  Response |
                                     +-----------+

Key Components

Pricing

AI Agent costs are pass-through with no Zavu markup. You pay exactly what the providers charge:

~Cost per Message assumes roughly 1,000 input and 150 output tokens. Provider prices move: the agent's model picker in the dashboard lists the catalog currently in force, and is what billing charges against.

Next Steps