Yapay Zeka Ajanları için Beceriler

GetMyBot Becerileri, GetMyBot API'nin üzerinde hazır ajan sarmalayıcılardır. Bir yapay zeka ajanına (örneğin Claude Code) botlarınızla doğal dilde çalışmayı öğretirler: "GetMyBot'ta bir tepki oluştur", "VIP etiketiyle GetMyBot toplu gönderinimi başlat", "bot istatistiklerini göster". Perde arkasında beceri GetMyBot MCP araçlarını çağırır; MCP sunucusu bağlı değilse tokeninizle REST üzerinden aynı istekleri yapar.

Beceriler ayrı bir ücretli özellik veya bir pazar yeri değildir. Bunlar, ajanınızın yanına yerel olarak kurduğunuz SKILL.md dosyalarıdır (Claude Code biçimi).

Nasıl Çalışır

Her beceri aşamalı açılım ilkesiyle yapılandırılmıştır: kısa bir açıklama beceeriyi alan ifadelerinde tetikler, ağır API referansı yalnızca gerektiğinde yüklenir. Her becerinin içinde iki erişim yolu belgelenmiştir:

  • MCP (tercih edilen) — GetMyBot MCP sunucusu ajana bağlıysa beceri araçları doğrudan çağırır.
  • REST-fallback — MCP kullanılamıyorsa beceri, kişisel tokenle curl istekleri yaparak aynı işlemleri gerçekleştirir.

Tüm becerilerdeki kimlik doğrulama aynıdır: mbp_… kişisel tokeni ve /api temel adresi. Ayrıntılar için yetkilendirme kılavuzuna bakın.

Altı Beceri

  • mybot — giriş noktası ve gezinti: GetMyBot API'si nedir, PAT ve kapsamları nasıl alınır, temel adres, MCP sunucusu nasıl bağlanır, REST mi MCP mi, hata biçimi, sayfalama ve limitler. Buradan ajan diğer beş beceriye ulaşır.
  • mybot-bots — bot bağlama ve yönetimi: token doğrulama, bağlama, liste ve kart, güncelleme, senkronizasyon, token değiştirme, aktarma, silme, ayarlar, şablonlar.
  • mybot-reactions — tepki oluşturucu (en büyük): "tetikleyici → koşullar → sohbetler → eylemler" yapısı, oluşturma ve güncelleme, tetikleyici türleri, VE/VEYA koşulları, eylem kataloğu, mesajlar ve düğmeler, dinamik düğmeler ve parametreler, formüller (DSL), klasörler, tepki bağlantıları, SamBot'tan içe aktarma, formül doğrulama, sıralama.
  • mybot-broadcasts — toplu gönderimleri: tepkiyle başlatma, etiketlere göre segmentasyon, duraklat/devam et/iptal ve durum, gönderilmiş mesajları düzenleme (tekil ve "hepsinde"), kuyruk ve yeniden denemeler.
  • mybot-data — veriler ve entegrasyonlar: koleksiyonlar (tablolar — alanlar ve kayıtlar), senaryolar (flows), entegrasyonlar (Yapay Zeka, Google Sheets, GetCourse, WebSocket üzerinden harici işleyici), bağlantılar ve erişimler.
  • mybot-analytics — gözlemlenebilirlik ve kitle: istatistik (bakiye harcaması, metrikler, günlük, tepki sağlığı), analitik (kitle, sohbetler, huniler), aboneler ve etiketler, diyaloglar, faturalama (bakiye, planlar, işlemler).

Kurulum

Beceriler GetMyBot deposunun skills/ klasöründedir. Her beceri, SKILL.md (kısa kılavuz) ve reference.md (MCP ve curl örnekleriyle alan için tam referans) dosyalarıyla birlikte bir skills/<name>/ klasörüdür.

Ajanın becerileri görmesi için bunları Claude Code beceri dizininize bağlayın. Depoda hazır bir betik mevcuttur:

./skills/install.sh

Bu betik, depo içindeki klasörlere ~/.claude/skills/<name> sembolik bağlantıları oluşturur — depodaki düzenlemeler ajanda anında görünür, fazladan kopyalar oluşmaz. Kurulumdan sonra görevi olağan kelimelerle ifade edin ("GetMyBot'ta otomatik yanıtlayıcı botu oluştur") ve ajan gerekli beceriyi kendisi çeker.

Sonraki Adımlar