On this page

Formát specifikace agenta

Agenti Tajo jsou definováni v markdown souborech. Každý soubor obsahuje YAML frontmatter (identita, nástroje, omezení) a markdown tělo (instrukce, strategie, pravidla). Tento formát je inspirován produkčními vzory agentů používanými v systémech pro multi-agentní orchestraci.

Struktura souboru

---
name: agent-name
description: Co tento agent dělá (max 160 znaků)
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
---

# Název agenta

Instrukce pro agenta v přirozeném jazyce...

Pole Frontmatter

Povinná pole

Pole	Typ	Popis
`name`	string	Unikátní identifikátor v kebab-case (např. `cart-recovery-agent`)
`description`	string	Co agent dělá (max 160 znaků)
`version`	string	Sémantická verze (např. `1.0.0`)
`tools`	array	Moduly Brevo MCP serveru, ke kterým agent může přistupovat

Pole chování

Pole	Typ	Výchozí	Popis
`temperature`	float	`0.3`	Teplota LLM. Nižší = determinističtější. Použijte 0.1-0.2 pro datové operace, 0.3-0.5 pro návrh kampaní
`max_tokens`	integer	`4096`	Maximální délka odpovědi na otočení
`model`	string	`claude-sonnet-4-6`	LLM model k použití

Pole spouštěčů

Pole	Typ	Výchozí	Popis
`triggers`	array	`[]`	Události, plány nebo webhooky spouštějící agenta
`triggers[].event`	string	-	Název události (např. `cart_abandoned`, `customer_created`)
`triggers[].schedule`	string	-	Cron výraz (např. `0 9 * * *` pro denně v 9:00)
`triggers[].webhook`	string	-	Cesta webhooku (např. `/agents/cart-recovery/trigger`)
`triggers[].conditions`	array	`[]`	Podmínky filtru spouštěče
`triggers[].debounce`	string	-	Okno debounce (např. `5m`, `1h`)

Pole oprávnění

Pole	Typ	Výchozí	Popis
`permissions`	array	`[]`	Požadované rozsahy oprávnění pro auditní stopu
`related_agents`	array	`[]`	ID agentů, na které agent může delegovat
`escalation`	string	-	Kam eskalovat při nejistotě agenta (`human`, `supervisor-agent`)

Nástroje: Mapování na MCP servery Brevo

Pole tools odkazuje na názvy modulů Brevo MCP serverů. Každý modul se mapuje na konkrétní endpoint mcp.brevo.com:

tools:
  # Kontakty a segmentace
  - brevo_contacts                    # /v1/brevo_contacts/mcp
  - brevo_lists                       # /v1/brevo_lists/mcp
  - brevo_segments                    # /v1/brevo_segments/mcp
  - brevo_attributes                  # /v1/brevo_attributes/mcp

  # Kampaně a zprávy
  - 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

  # Analytika
  - brevo_campaign_analytics          # /v1/brevo_campaign_analytics/mcp

  # Prodejní 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

Používejte minimální sadu nástrojů potřebnou pro vašeho agenta. Méně nástrojů = lepší uvažování AI a rychlejší odpovědi. Viz Brevo MCP server pro všechny dostupné moduly.

Nasazení

Programové spuštění agenta

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",
  // Připojte pouze MCP servery uvedené v poli tools agenta
  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);    // Úplná auditní stopa
console.log(result.metrics);      // Sledované události

Spuštění přes Claude Code

# Nasměrujte na specifikaci agenta a nechte Claude ji spustit
claude "Run the agent defined in ./agents/cart-recovery-agent.md for today's abandoned carts"

Plánování pomocí cron

# Spusťte agenta zákaznické inteligence každé pondělí v 6:00
0 6 * * MON claude --print "Run ./agents/customer-intelligence.md weekly analysis" >> /var/log/tajo-agents.log 2>&1

Další kroky

Brevo MCP server, Dostupné nástroje a konfigurace serveru
Budování prvního agenta, Praktický průvodce
Přehled dovedností, Dovednosti Tajo skládající se s agenty
Přehled architektury MCP, Jak vše do sebe zapadá

Formát specifikace agenta