ایجنٹ مواصفات فارمیٹ
ایجنٹ مواصفات فارمیٹ
Tajo ایجنٹس markdown فائلوں میں تعریف کیے جاتے ہیں۔ ہر فائل میں YAML frontmatter (شناخت، ٹولز، پابندیاں) اور markdown باڈی (ہدایات، حکمت عملی، قواعد) ہوتے ہیں۔
فائل ڈھانچہ
---name: agent-namedescription: What this agent does (max 160 chars)version: 1.0.0temperature: 0.2max_tokens: 4096tools: - brevo_contacts - brevo_email_campaign_management - brevo_sms_campaignstriggers: - event: cart_abandoned - schedule: "0 */4 * * *"permissions: - contacts:read - email:send - sms:send---
# Agent Name
Instructions for the agent in natural language...Frontmatter فیلڈز
ضروری فیلڈز
| فیلڈ | قسم | تفصیل |
|---|---|---|
name | string | kebab-case میں منفرد شناخت کنندہ (مثلاً cart-recovery-agent) |
description | string | یہ ایجنٹ کیا کرتا ہے (زیادہ سے زیادہ 160 حروف) |
version | string | سیمنٹک ورژن (مثلاً 1.0.0) |
tools | array | Brevo MCP سرور ماڈیولز جن تک یہ ایجنٹ رسائی کر سکتا ہے |
رویے کے فیلڈز
| فیلڈ | قسم | ڈیفالٹ | تفصیل |
|---|---|---|---|
temperature | float | 0.3 | LLM درجہ حرارت۔ کم = زیادہ قطعی۔ ڈیٹا آپریشنز کے لیے 0.1-0.2، مہم ڈیزائن کے لیے 0.3-0.5 استعمال کریں |
max_tokens | integer | 4096 | فی باری زیادہ سے زیادہ جواب کی لمبائی |
model | string | claude-sonnet-4-6 | LLM ماڈل استعمال کرنا ہے |
ٹرگر فیلڈز
| فیلڈ | قسم | ڈیفالٹ | تفصیل |
|---|---|---|---|
triggers | array | [] | ایونٹس، شیڈولز، یا webhooks جو اس ایجنٹ کو فعال کرتے ہیں |
triggers[].event | string | - | ایونٹ کا نام (مثلاً cart_abandoned) |
triggers[].schedule | string | - | cron اظہار (مثلاً 0 9 * * * روزانہ صبح 9 بجے) |
triggers[].webhook | string | - | webhook راستہ (مثلاً /agents/cart-recovery/trigger) |
triggers[].conditions | array | [] | ٹرگر کے لیے فلٹر شرائط |
triggers[].debounce | string | - | 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/mcpTip
اپنے ایجنٹ کی ضرورت کے کم سے کم ٹولز استعمال کریں۔ کم ٹولز = بہتر 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کثیر ایجنٹ چینز
پیچیدہ ورک فلوز کے لیے، متعدد ایجنٹس کو چین میں تالیف کریں:
name: quarterly-retention-campaignsteps: - 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 کے ذریعے چلانا
claude "Run the agent defined in ./agents/cart-recovery-agent.md for today's abandoned carts"Cron کے ساتھ شیڈولنگ
# کسٹمر انٹیلیجنس ایجنٹ ہر پیر صبح 6 بجے چلائیں0 6 * * MON claude --print "Run ./agents/customer-intelligence.md weekly analysis" >> /var/log/tajo-agents.log 2>&1اگلے اقدامات
- Brevo MCP سرور, دستیاب ٹولز اور سرور کنفیگریشن
- اپنا پہلا ایجنٹ بنانا, عملی ٹیوٹوریل
- اسکلز ریفرنس, Tajo اسکلز جو ایجنٹس کے ساتھ مل کر کام کرتی ہیں
- MCP آرکیٹیکچر جائزہ, سب کچھ کیسے فٹ ہوتا ہے