Agent Specification
Agent Specification
Tajo agents YAML frontmatter के साथ markdown files हैं। यह document complete specification format define करता है।
Complete Specification
---# Required fieldsname: agent-name # Unique identifier (lowercase, hyphens)description: "Agent description" # Brief description of agent purpose
# Optional metadataversion: 1.0.0 # Semantic versionauthor: "Team Name"
# Model configurationtemperature: 0.3 # 0.0 (deterministic) to 1.0 (creative)max_tokens: 4096 # Maximum response length
# MCP tools this agent can usetools: - 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 agenttriggers: - schedule: "0 9 * * *" # Cron syntax (daily 9 AM UTC) - event: cart_abandoned # Platform event - event: order_completed - webhook: "https://..." # External webhook
# Permission scopingpermissions: - contacts:read - contacts:write - email:send - sms:send - whatsapp:send - segments:manage - analytics:read
# Environment variablesenv: SYNC_INTERVAL: "6h" MAX_CONTACTS_PER_RUN: "1000"---Frontmatter Fields
Required Fields
| Field | Type | विवरण |
|---|---|---|
name | string | Unique agent identifier। Lowercase letters, numbers, hyphens। |
description | string | Agent का brief purpose description। |
Model Configuration
| Field | Type | Default | विवरण |
|---|---|---|---|
temperature | float | 0.3 | Creativity vs determinism। Data sync के लिए 0.1, creative writing के लिए 0.7। |
max_tokens | integer | 4096 | Maximum 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 dataTriggers
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
| Permission | Access |
|---|---|
contacts:read | Contacts read करें |
contacts:write | Contacts create/update करें |
email:send | Emails भेजें |
sms:send | SMS messages भेजें |
whatsapp:send | WhatsApp messages भेजें |
segments:manage | Segments create और modify करें |
analytics:read | Analytics data read करें |
campaigns:manage | Campaigns 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 यूंअगले कदम
- Agents बनाना, Practical examples
- Brevo MCP Server, Available tools reference
- Shopify + Brevo, Integration example