Ajan Spesifikasyonu Formatı

Ajan Spesifikasyonu Formatı

Tajo ajanları markdown dosyalarında tanımlanır. Her dosya YAML frontmatter (kimlik, araçlar, kısıtlamalar) ve markdown gövdesi (talimatlar, strateji, kurallar) içerir.

Dosya Yapısı

---
name: agent-name
description: Bu ajanın ne yaptığı (max 160 karakter)
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
---
# Ajan Adı
Doğal dilde ajan talimatları...

Frontmatter Alanları

Zorunlu Alanlar

AlanTürAçıklama
namestringkebab-case’de benzersiz tanımlayıcı (örn. cart-recovery-agent)
descriptionstringBu ajanın ne yaptığı (max 160 karakter)
versionstringSemantik sürüm (örn. 1.0.0)
toolsarrayBu ajanın erişebildiği Brevo MCP sunucu modülleri

Davranış Alanları

AlanTürVarsayılanAçıklama
temperaturefloat0.3LLM sıcaklığı. Düşük = daha deterministik. Veri işlemleri için 0.1-0.2, kampanya tasarımı için 0.3-0.5 kullanın
max_tokensinteger4096Tur başına maksimum yanıt uzunluğu
modelstringclaude-sonnet-4-6Kullanılacak LLM modeli

Araçlar: Brevo MCP Sunucularıyla Eşleme

tools:
- brevo_contacts # /v1/brevo_contacts/mcp
- brevo_segments # /v1/brevo_segments/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_campaign_analytics # /v1/brevo_campaign_analytics/mcp
- brevo_deals # /v1/brevo_deals/mcp

Tetikleyiciler

Olay Tetikleyicileri

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

Zamanlama Tetikleyicileri

triggers:
- schedule: "0 9 * * MON" # Her Pazartesi saat 9:00'da
timezone: "Europe/Istanbul"
- schedule: "0 */4 * * *" # Her 4 saatte bir

Dağıtım

Programatik Ajan Çalıştırma

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); // Tam denetim izi
console.log(result.metrics); // Takip edilen olaylar

Sonraki Adımlar

Subscribe to updates

developer-docs

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

AI Asistan

Merhaba! Belgeler hakkında her şeyi sorabilirsiniz.

Brevo ile ücretsiz başlayın