Ajanlar

Ajan, cron zamanlamalı kadansta gözetimsiz gönderi taslağı hazırlayan otonom bir worker'dır. Ajanlar approval_status: pending_review'da taslaklar üretir, doğrudan asla yayınlamaz — onayı her zaman insanlar verir.

Endpoint'ler

GET    /api/v1/ai-agents                  listele
POST   /api/v1/ai-agents                  oluştur — bir cron işi kaydeder
GET    /api/v1/ai-agents/:id              bir tane çek
PATCH  /api/v1/ai-agents/:id              güncelle — cron değiştiyse yeniden zamanlar
DELETE /api/v1/ai-agents/:id              sil — zamanlamayı kaldırır
POST   /api/v1/ai-agents/:id/run          manuel tetikle (tek seferlik)
GET    /api/v1/ai-agents/:id/runs         geçmiş çalıştırma geçmişi

Ajan modeli

{
  name: string,
  role: string,                    // system prompt için rol/persona
  persona: string,                 // ton, ses
  system_prompt: string,           // açık system prompt
  schedule_cron: string,           // 5 alanlı cron, örn. "0 9 * * *"
  timezone: string,                // varsayılan UTC
  accounts: ObjectId[],            // hedef sosyal kanallar
  posts_per_run: number,           // 1–10
  daily_limit: number,             // 1–50
  active: boolean,
  posts_today: number,
  posts_today_date: Date,          // UTC gece yarısı sıfırlanır
}

Çalıştırma

ai-agents BullMQ kuyruğu, ajan başına tekrarlayan bir iş çalıştırır. Her çalıştırma (aiAgents.runner.ts):

1. Ajanı ve kullanıcının son 5 gönderisini (bağlam için) yükler.
2. Günlük limiti kontrol eder — tükendiyse 0 gönderi döner.
3. Qevron gateway üzerinden min(posts_per_run, daily_remaining)'e kadar gönderi taslağı üretir (gönderi başına maks 512 token).
4. Her birini status: 0 (taslak), post_by: 3 (taslak), approval_status: "pending_review" ile bir Post dokümanı olarak saklar.
5. Çalıştırmayı AgentRuns'a kaydeder ve posts_today'i artırır.

POST /ai-agents/:id/run üzerinden manuel çalıştırmalar tek seferlik bir iş kuyruğa alır — cron timer'ı atlar ama daily_limit'e uyar.

Maliyet

Çağrı başına ölçülmez. Ajanlar taslaklar oluşturur; altta yatan metin üretimi çağrı-başı kredi düşümü değil, çalışma alanının genel AI kapasitesini kullanır.

İlgili

Promptlar

Taslaklar

Editör Genel Bakış