Custom Agent

Bu rehberde: Hazır ajanların kapsamadığı işler için kendi ajanınızı tanımlamayı öğrenirsiniz. Ana talimatı siz yazarsınız, araçları siz seçersiniz.

⏱ 12 dakika

Kimlik kartı#

Ne yapar?#

Custom Agent boş bir ajan iskeletidir. Ana talimatı (sistem prompt'u) siz yazarsınız. Araç listesinden istediğinizi seçersiniz. İsterseniz çıktının uyması gereken bir JSON şeması verirsiniz. Diğer ajanlar gibi proje bilgilerini, strateji belgesini ve bütçe/adım sınırlarını alır.

Ne zaman kullanılır? Ürün açıklaması yazarı, mesaj sınıflandırıcı, rakip fiyat izleyici, çok adımlı veri toplayıcı, marka uyum denetçisi gibi hazır ajanların yapmadığı işler.

Bu kutuda Görev alanı zorunludur.

Girdiler#

Ortak alanlar: Görev (zorunlu), Entegrasyonlar, Model, Düşünme derinliği, Maks. adım, Bütçe, Rapor kaydet.

Çıktılar#

main çıkışından tek öğe: şema varsa şemaya uyan nesne; yoksa { result: <metin veya JSON> }. report çıkışından Genel rapor (rapor kaydet açıksa).

Şema örneği (ürün açıklaması):

{
  "type": "object",
  "required": ["items"],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["sku", "title", "description", "bullets"],
        "properties": {
          "sku": { "type": "string" },
          "title": { "type": "string", "maxLength": 70 },
          "description": { "type": "string" },
          "bullets": { "type": "array", "items": { "type": "string" }, "maxItems": 5 },
          "seoKeywords": { "type": "array", "items": { "type": "string" } }
        }
      }
    }
  }
}

Çıktı doğrudan { "items": [ … ] } olur; Kod kutusuyla öğelere ayırabilirsiniz.

Geliştirici notu: Şema zorlaması Anthropic'te output_config.format, OpenAI'de text.format (json_schema) ile yapılır.

Kullanılabilir araçlar#

Dikkat: Yazma yapan araçları (publish_post, send_message, update_strategy) yalnızca gerektiğinde verin. Ajan yalnızca listede olan araçları çağırabilir.

Örnek kurulumlar#

1. Ürün açıklaması yazarı

• Sistem prompt'u: "E-ticaret ürün açıklaması yazarısın. Marka sesine uy. Her ürün için 70 karakterlik başlık, 80-120 kelimelik açıklama, 3-5 fayda maddesi ve 5 SEO anahtar kelimesi üret. Abartı ve tıbbi iddia yok."
• Araçlar: fetch_url
• Şema: yukarıdaki
• Görev: "Şu ürün sayfalarındaki ürünler için açıklama yaz: {{ $node["Find products"].all().map(i => i.json.url).join(", ") }}"

2. Gelen mesaj sınıflandırıcı

• Sistem prompt'u: "Müşteri mesajlarını sınıfla: intent ∈ {sales, support, complaint, spam}, urgency 1-5, language. Gerekirse bilgi bankasında ara."
• Araçlar: knowledge_search, get_conversation_history
• Şema: { "type":"object","required":["intent","urgency","language"],"properties":{"intent":{"enum":["sales","support","complaint","spam"]},"urgency":{"type":"integer","minimum":1,"maximum":5},"language":{"type":"string"},"reason":{"type":"string"}}}
• Görev: "Mesaj: {{ $json.text }}"

3. Rakip fiyat izleyici

• Sistem prompt'u: "Verilen ürün sayfalarından fiyatı, para birimini ve stok durumunu çıkar. Bulamazsan null yaz."
• Araçlar: fetch_url
• Görev: "Sayfalar: {{ $vars.competitorPriceUrls }}" → çıktı Depolama kutusuyla önceki değerle karşılaştırılır.

4. Marka uyum denetçisi

• Sistem prompt'u: "Marka sesi kurallarına göre metni denetle; uygunsuz ifadeleri listele ve düzeltilmiş sürüm yaz."
• Görev: "Metin: {{ $json.body }}" → Eğer ({{ $json.compliant === true }}).

5. Haftalık rakip haber özeti

• Araçlar: web_search, fetch_url, notify_owner
• Görev: "{{ $project.competitors.join(", ") }} hakkında son 7 günün haberlerini bul ve 5 maddede özetle; önemliyse proje sahibine bildir."

İpuçları#

• Sistem prompt'unda rol, kurallar, çıktı biçimi sırasını izleyin; örnek çıktı ekleyin.
• Şema kullanıyorsanız prompt'ta biçim anlatmanız gerekmez; şema zorlayıcıdır. claude-fable-5-1 zorunlu araç seçimini desteklemez; "önce X aracını çağır" demeniz yeterlidir.
• Maks. adımı küçük tutun (5-10); araçsız görevler tek adımda biter.
• Kayıtlı ajan olarak kaydedin ve kutuda Ajan alanından seçin; prompt tek yerde yönetilir ve bellek çalışır.
• $env yoktur; anahtarlar entegrasyon veya $vars üzerinden gelir.

Beklenen rapor#

Genel rapor: görev, özet, sonuç, kullanılan araçlar ve adım sayısı. Sınıflandırma gibi yüksek hacimli kullanımlarda Rapor kaydet'i kapatın.

Maliyet beklentisi#

Şemalı çıktı ek maliyet getirmez. Yüksek hacimde ekonomi model ve bütçe 0.05-0.2 $.

İş akışında kullanım#

• Mesaj geldi → Custom Agent (sınıflandırıcı) → Anahtar ({{ $json.intent }}, yollar [sales, support, complaint]).
• RSS → Custom Agent (özetleyici) → Rapor.
• Zamanlama → Custom Agent (fiyat izleyici) → Depolama → Eğer (fiyat değişti) → Bildir.

İpucu: Basit tek çağrılar için Metin üret, Veri çıkar, Sınıfla kutuları daha ucuz ve hızlıdır. Araç kullanımı, çok adımlı düşünme veya bellek gerekiyorsa Custom Agent seçin.

Sık karşılaşılan sorunlar#

Sık sorulan sorular#

Kod yazmam gerekir mi? Hayır. Sistem prompt'u düz metindir. Şema isteğe bağlıdır; JSON biçimi biraz teknik olsa da örneği kopyalayıp düzenleyebilirsiniz.

Hazır ajanlardan ne farkı var? Hazır ajanların ince ayarlı talimatları, araçları ve rapor biçimi vardır. Custom Agent'ta bunları siz belirlersiniz. Daha esnek ama daha çok deneme gerektirir.

Yazma araçları vermek güvenli mi? Yalnızca gerekirse verin ve onay adımıyla kullanın. Ajan verdiğiniz araçları kullanabilir; vermediğinizi kullanamaz.

Sonraki adım#

• Ajanlara genel bakış
• Yapay zekâ node'ları
• İfade sözdizimi