​

AI Agents

​

How It Works

User Message → Orbit API → Agent Runtime → Anthropic Claude → Tool Calls → Response
                                ↓
                         State Graph (LangGraph)
                                ↓
                     Memory / Context / Tools

1. Inbound trigger — a user sends a message or calls a number routed to an agent
2. State evaluation — the agent runtime loads the conversation state and determines the next step
3. LLM reasoning — the agent sends conversation context to Anthropic’s Claude for a decision
4. Tool execution — the agent calls tools (APIs, databases, functions) as needed
5. Response — the agent replies to the user via the appropriate channel

​

Agent Types

​

Key Capabilities

• Multi-turn conversations — maintain context across messages with persistent memory
• Tool calling — invoke APIs, query databases, trigger workflows
• Guardrails — content filtering, PII redaction, and safety limits enforced inside the agent runtime
• Handoff — seamlessly transfer to human agents with full context
• Multi-language — converse in 18 languages with automatic detection
• Analytics — track resolution rates, latency, and cost per conversation

​

Quick Example

import { Devotel } from '@devotel/orbit-sdk';

const client = new Devotel({ apiKey: 'dv_live_sk_...' });

const agent = await client.agents.create({
  name: 'FAQ Bot',
  model: 'claude-sonnet-4-6',
  system_prompt: 'You are a helpful FAQ bot for Acme Corp. Answer questions about our products and services.',
  tools: ['search_knowledge'],
  knowledge_base_ids: ['kb_acme_faq'],
});

Channels are not set at create time — there is no channels field on the agent. Bind the agent to a channel (sms, whatsapp, voice, rcs, or webhook) with POST /api/v1/agents/:id/deploy, sending { "channel": "sms", "phone_number": "+1..." } — one call per channel. See Creating Agents → Deploy.

The search_knowledge built-in tool performs semantic retrieval, but it only grounds in content you attach via knowledge_base_ids. Without a linked knowledge base it has nothing to search. See the full built-in tool registry in Creating Agents.

​

Next Steps

• Creating Agents — step-by-step setup guide
• Agent Marketplace — pre-built templates
• Flows — connect agents to visual workflows