ایجنٹ مواصفات فارمیٹ

ایجنٹ مواصفات فارمیٹ

Tajo ایجنٹس markdown فائلوں میں تعریف کیے جاتے ہیں۔ ہر فائل میں YAML frontmatter (شناخت، ٹولز، پابندیاں) اور markdown باڈی (ہدایات، حکمت عملی، قواعد) ہوتے ہیں۔

فائل ڈھانچہ

---
name: agent-name
description: What this agent does (max 160 chars)
version: 1.0.0
temperature: 0.2
max_tokens: 4096
tools:
- brevo_contacts
- brevo_email_campaign_management
- brevo_sms_campaigns
triggers:
- event: cart_abandoned
- schedule: "0 */4 * * *"
permissions:
- contacts:read
- email:send
- sms:send
---
# Agent Name
Instructions for the agent in natural language...

Frontmatter فیلڈز

ضروری فیلڈز

فیلڈقسمتفصیل
namestringkebab-case میں منفرد شناخت کنندہ (مثلاً cart-recovery-agent)
descriptionstringیہ ایجنٹ کیا کرتا ہے (زیادہ سے زیادہ 160 حروف)
versionstringسیمنٹک ورژن (مثلاً 1.0.0)
toolsarrayBrevo MCP سرور ماڈیولز جن تک یہ ایجنٹ رسائی کر سکتا ہے

رویے کے فیلڈز

فیلڈقسمڈیفالٹتفصیل
temperaturefloat0.3LLM درجہ حرارت۔ کم = زیادہ قطعی۔ ڈیٹا آپریشنز کے لیے 0.1-0.2، مہم ڈیزائن کے لیے 0.3-0.5 استعمال کریں
max_tokensinteger4096فی باری زیادہ سے زیادہ جواب کی لمبائی
modelstringclaude-sonnet-4-6LLM ماڈل استعمال کرنا ہے

ٹرگر فیلڈز

فیلڈقسمڈیفالٹتفصیل
triggersarray[]ایونٹس، شیڈولز، یا webhooks جو اس ایجنٹ کو فعال کرتے ہیں
triggers[].eventstring-ایونٹ کا نام (مثلاً cart_abandoned)
triggers[].schedulestring-cron اظہار (مثلاً 0 9 * * * روزانہ صبح 9 بجے)
triggers[].webhookstring-webhook راستہ (مثلاً /agents/cart-recovery/trigger)
triggers[].conditionsarray[]ٹرگر کے لیے فلٹر شرائط
triggers[].debouncestring-debounce ونڈو (مثلاً 5m, 1h)

ٹولز: Brevo MCP سرورز سے نقشہ سازی

tools فیلڈ Brevo MCP سرور ماڈیول ناموں کا حوالہ دیتا ہے:

tools:
# رابطے اور سیگمنٹیشن
- brevo_contacts # /v1/brevo_contacts/mcp
- brevo_lists # /v1/brevo_lists/mcp
- brevo_segments # /v1/brevo_segments/mcp
- brevo_attributes # /v1/brevo_attributes/mcp
# مہمات اور پیغام رسانی
- brevo_email_campaign_management # /v1/brevo_email_campaign_management/mcp
- brevo_templates # /v1/brevo_templates/mcp
- brevo_sms_campaigns # /v1/brevo_sms_campaigns/mcp
- brevo_whatsapp_campaigns # /v1/brevo_whatsapp_campaigns/mcp
# تجزیات
- brevo_campaign_analytics # /v1/brevo_campaign_analytics/mcp
# سیلز CRM
- brevo_deals # /v1/brevo_deals/mcp
- brevo_companies # /v1/brevo_companies/mcp
- brevo_tasks # /v1/brevo_tasks/mcp
- brevo_pipelines # /v1/brevo_pipelines/mcp
- brevo_notes # /v1/brevo_notes/mcp

Tip

اپنے ایجنٹ کی ضرورت کے کم سے کم ٹولز استعمال کریں۔ کم ٹولز = بہتر AI استدلال اور تیز جوابات۔ تمام دستیاب ماڈیولز کے لیے Brevo MCP سرور دیکھیں۔

ٹرگرز

ایونٹ ٹرگرز

triggers:
- event: cart_abandoned
conditions:
- cart_value: "> 50"
- items_count: ">= 1"
- time_since_activity: "> 30m"
debounce: 5m

شیڈول ٹرگرز

triggers:
- schedule: "0 9 * * MON" # ہر پیر صبح 9 بجے
timezone: "America/New_York"
- schedule: "0 */4 * * *" # ہر 4 گھنٹے
- schedule: "0 0 1 * *" # ہر مہینے کا پہلا دن

Webhook ٹرگرز

triggers:
- webhook: /agents/win-back/trigger
method: POST
authentication: api_key

کثیر ایجنٹ چینز

پیچیدہ ورک فلوز کے لیے، متعدد ایجنٹس کو چین میں تالیف کریں:

chain.yaml
name: quarterly-retention-campaign
steps:
- agent: customer-intelligence
input: |
Analyze customer segments for Q2 retention campaign.
Goal: {task}
- agent: campaign-designer
input: |
Design retention campaigns for these segments:
{previous}
- agent: campaign-executor
input: |
Execute these campaigns via Brevo:
{previous}
- agent: campaign-reporter
input: |
Generate the retention campaign launch report:
{previous}

ڈیپلائمنٹ

ایجنٹ پروگرامیٹک طریقے سے چلانا

import { TajoAgent } from "@tajo/agent-sdk";
const agent = new TajoAgent({
specPath: "./agents/cart-recovery-agent.md",
brevoToken: process.env.BREVO_MCP_TOKEN,
model: "claude-sonnet-4-6",
autoConnectServers: true,
});
const result = await agent.run(
"Recover abandoned carts over $50 from the last 4 hours"
);
console.log(result.summary);
console.log(result.toolCalls); // مکمل آڈٹ ٹریل
console.log(result.metrics); // ٹریک کیے گئے ایونٹس

Claude Code کے ذریعے چلانا

Terminal window
claude "Run the agent defined in ./agents/cart-recovery-agent.md for today's abandoned carts"

Cron کے ساتھ شیڈولنگ

Terminal window
# کسٹمر انٹیلیجنس ایجنٹ ہر پیر صبح 6 بجے چلائیں
0 6 * * MON claude --print "Run ./agents/customer-intelligence.md weekly analysis" >> /var/log/tajo-agents.log 2>&1

اگلے اقدامات

Subscribe to updates

developer-docs

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

AI معاون

السلام علیکم! دستاویزات کے بارے میں کچھ بھی پوچھیں۔

Brevo کے ساتھ مفت شروع کریں