Định Dạng Đặc Tả Tác Nhân
Định Dạng Đặc Tả Tác Nhân
Các tác nhân Tajo được định nghĩa trong file markdown. Mỗi file chứa frontmatter YAML (danh tính, công cụ, ràng buộc) và phần thân markdown (hướng dẫn, chiến lược, quy tắc).
Cấu Trúc File
---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...Trường Frontmatter
Trường Bắt Buộc
| Trường | Kiểu | Mô tả |
|---|---|---|
name | string | Định danh duy nhất dạng kebab-case (vd. cart-recovery-agent) |
description | string | Tác nhân này làm gì (tối đa 160 ký tự) |
version | string | Phiên bản ngữ nghĩa (vd. 1.0.0) |
tools | array | Module máy chủ Brevo MCP mà tác nhân có thể truy cập |
Trường Hành Vi
| Trường | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
temperature | float | 0.3 | Nhiệt độ LLM. Thấp hơn = xác định hơn. Dùng 0.1-0.2 cho thao tác dữ liệu, 0.3-0.5 cho thiết kế chiến dịch |
max_tokens | integer | 4096 | Độ dài phản hồi tối đa mỗi lượt |
model | string | claude-sonnet-4-6 | Mô hình LLM sử dụng |
Trường Trigger
| Trường | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
triggers | array | [] | Sự kiện, lịch hoặc webhook kích hoạt tác nhân |
triggers[].event | string | - | Tên sự kiện (vd. cart_abandoned) |
triggers[].schedule | string | - | Biểu thức cron (vd. 0 9 * * * cho 9am hàng ngày) |
triggers[].webhook | string | - | Đường dẫn webhook (vd. /agents/cart-recovery/trigger) |
triggers[].conditions | array | [] | Điều kiện lọc cho trigger |
triggers[].debounce | string | - | Cửa sổ debounce (vd. 5m, 1h) |
Công Cụ: Ánh Xạ Đến Máy Chủ Brevo MCP
Trường tools tham chiếu tên module máy chủ Brevo MCP:
tools: # Liên Hệ và Phân Khúc - brevo_contacts # /v1/brevo_contacts/mcp - brevo_lists # /v1/brevo_lists/mcp - brevo_segments # /v1/brevo_segments/mcp - brevo_attributes # /v1/brevo_attributes/mcp
# Chiến Dịch và Nhắn Tin - 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
# Phân Tích - brevo_campaign_analytics # /v1/brevo_campaign_analytics/mcp
# Sales 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
Sử dụng bộ công cụ tối thiểu mà tác nhân cần. Ít công cụ hơn = AI suy luận tốt hơn và phản hồi nhanh hơn.
Chuỗi Đa Tác Nhân
Đối với luồng công việc phức tạp, kết hợp nhiều tác nhân thành chuỗi:
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}Triển Khai
Chạy Tác Nhân Theo Cách Lập Trình
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); // Đường kiểm tra đầy đủconsole.log(result.metrics); // Sự kiện đã theo dõiChạy Qua Claude Code
claude "Run the agent defined in ./agents/cart-recovery-agent.md for today's abandoned carts"Các Bước Tiếp Theo
- Máy Chủ Brevo MCP, Công cụ có sẵn và cấu hình máy chủ
- Xây Dựng Tác Nhân Đầu Tiên, Hướng dẫn thực hành
- Tham Khảo Kỹ Năng, Kỹ năng Tajo kết hợp với tác nhân
- Tổng Quan Kiến Trúc MCP, Cách mọi thứ khớp với nhau