Agent Specification

Agent Specification

Tajo agents YAML frontmatter के साथ markdown files हैं। यह document complete specification format define करता है।

Complete Specification

---
# Required fields
name: agent-name # Unique identifier (lowercase, hyphens)
description: "Agent description" # Brief description of agent purpose
# Optional metadata
version: 1.0.0 # Semantic version
author: "Team Name"
# Model configuration
temperature: 0.3 # 0.0 (deterministic) to 1.0 (creative)
max_tokens: 4096 # Maximum response length
# MCP tools this agent can use
tools:
- brevo_contacts
- brevo_email_campaign_management
- brevo_templates
- brevo_sms_campaigns
- brevo_whatsapp_campaigns
- brevo_segments
- brevo_attributes
- brevo_lists
- brevo_deals
- brevo_campaign_analytics
# When to trigger this agent
triggers:
- schedule: "0 9 * * *" # Cron syntax (daily 9 AM UTC)
- event: cart_abandoned # Platform event
- event: order_completed
- webhook: "https://..." # External webhook
# Permission scoping
permissions:
- contacts:read
- contacts:write
- email:send
- sms:send
- whatsapp:send
- segments:manage
- analytics:read
# Environment variables
env:
SYNC_INTERVAL: "6h"
MAX_CONTACTS_PER_RUN: "1000"
---

Frontmatter Fields

Required Fields

FieldTypeविवरण
namestringUnique agent identifier। Lowercase letters, numbers, hyphens।
descriptionstringAgent का brief purpose description।

Model Configuration

FieldTypeDefaultविवरण
temperaturefloat0.3Creativity vs determinism। Data sync के लिए 0.1, creative writing के लिए 0.7
max_tokensinteger4096Maximum output tokens।

Tools

Agent जिन Brevo MCP modules को access कर सकता है:

tools:
- brevo_contacts # Contact CRUD operations
- brevo_lists # List management
- brevo_segments # Segment creation/management
- brevo_attributes # Custom attribute management
- brevo_email_campaign_management # Email campaigns
- brevo_templates # Email templates
- brevo_sms_campaigns # SMS campaigns
- brevo_whatsapp_campaigns # WhatsApp campaigns
- brevo_deals # CRM deals
- brevo_companies # CRM companies
- brevo_campaign_analytics # Analytics data

Triggers

triggers:
# Cron schedule (UTC)
- schedule: "0 9 * * *" # Daily 9 AM
- schedule: "0 */6 * * *" # Every 6 hours
- schedule: "0 9 * * 1" # Weekly Monday 9 AM
# Platform events
- event: cart_abandoned
- event: order_completed
- event: customer_created
- event: payment_failed
- event: subscription_cancelled
# Webhooks
- webhook: "https://your-app.com/webhooks/agent"

Permissions

PermissionAccess
contacts:readContacts read करें
contacts:writeContacts create/update करें
email:sendEmails भेजें
sms:sendSMS messages भेजें
whatsapp:sendWhatsApp messages भेजें
segments:manageSegments create और modify करें
analytics:readAnalytics data read करें
campaigns:manageCampaigns create और modify करें

Agent Body

Frontmatter के बाद markdown में agent instructions आते हैं:

# Agent Name
Agent क्या करता है इसका brief description।
## Strategy
Agent problem को कैसे approach करेगा।
## Rules
- ALWAYS rule one
- NEVER rule two
- Handle edge case three यूं

अगले कदम

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

AI Assistant

Hi! Ask me anything about the docs.

Brevo के साथ मुफ्त में शुरू करें