Bağlayıcılar CLI Referansı

Katalogdan çalışan bir örneğe giden en kısa yolu istediğinizde chainabit connectors komutunu kullanın.

Bağlantı sahipliği ve çalışma alanı

Kişisel çalışma alanında yalnızca Bağlantılarım bulunur; Takım bağlantıları seçeneği gösterilmez. Aynı sağlayıcıyı kullanan kişisel bağlantılar ve çalışma alanı bağlantıları ayrı kalır.

Otomasyon izni belirli bir bağlantı, ajan veya zincir, araç kümesi ve sonuç kitlesi için verilir. Kişisel sonuçlar varsayılan olarak sahibine özeldir. İzni kaldırmak sonraki kullanımı durdurur; daha önce açıkça paylaşılan sonuçları geri çekmez.

Kurulum ve Keşif

chainabit connectors list
chainabit connectors list --category productivity
chainabit connectors list --active --locale tr
chainabit connectors get slack
chainabit connectors install slack --name "My Slack" --scope personal

connectors list kataloğu gösterir. connectors install varsayılan olarak kişisel bağlantı oluşturur. Betiklerde --scope personal kullanın. --scope team, etkinleştirilmiş bir Business hesabı ve etkin çalışma alanında owner veya admin yetkisi gerektirir. Tek üyeli Business hesabı Business olarak kalır.

Kişisel bağlantıyı sahibi, çalışma alanı bağlantısını ait olduğu Business çalışma alanının owner veya admin üyeleri yönetir. Plan erişimi ve güncel çalışma alanı erişimi de gerekir. Business çalışma alanında kişisel bağlantı kullanımı için yöneticinin politikayı açması ve bağlantı sahibinin o çalışma alanına izin vermesi gerekir. Çalışma alanını değiştirmek kullanılabilir bağlantıları değiştirir; bağlantı kimliğini bilmek erişim sağlamaz.

Chao Araç Erişimi ve kesin bağlantılar

CLI, sunucu sahipli Araç Erişimi tercihini okur ve değiştirir:

chainabit connectors settings
chainabit connectors settings on_demand
chainabit connectors settings eager

Bir Chao turunda genel bir bağlayıcı adına güvenmek yerine kesin bağlantı örneğini belirtin:

chainabit chao --message "Şirket Drive dosyalarını listele" \
  --connector <connection-id> --tool-access on_demand

--tool-access yalnızca bu tur için geçerlidir; CLI içinde ikinci bir bağlayıcı ayar kaynağı oluşturmaz. Çalışma zamanı bağlantı, yeniden bağlanma, seçim veya ajan iliştirme gereksinimi döndürürse istenen işlemi tamamlayın ve sunucu sözleşmesi üzerinden devam edin; başka bir bağlayıcıyla değiştirmeyin.

connectors list --json komutundan örnek JSON çıktısı:

[
  {
    "key": "slack",
    "displayName": "Slack",
    "category": "communication",
    "authType": "oauth2",
    "supportedFeatures": ["tool_discovery", "health_check"],
    "isActive": true
  }
]

Bir Örneğin Kimliğini Doğrulama

Tarayıcı tabanlı bağlayıcılar varsayılan OAuth akışını kullanır:

chainabit connectors auth inst_123

Bu yol etkileşimlidir. CI veya diğer etkileşimsiz işlerde, bağlayıcı destekliyorsa bir yazılı kimlik bilgisi işareti kullanın.

Bağlayıcınız bir API anahtarı, bearer token, bağlantı dizesi, temel kimlik doğrulaması veya özel kimlik bilgisi yükü kullanıyorsa, bunun yerine ilgili işareti iletin:

chainabit connectors auth inst_123 --api-key-env SLACK_API_KEY
chainabit connectors auth inst_123 --token-file ./.secrets/github-token.txt
chainabit connectors auth inst_123 --connection-string-env ANALYTICS_DB_URL
chainabit connectors auth inst_123 --username api-user --password-env CONNECTOR_PASSWORD
chainabit connectors auth inst_123 --custom-file ./.secrets/custom-credentials.json

Bir tarayıcıyı otomatik olarak başlatmak yerine OAuth URL'sini manuel olarak kopyalamak istiyorsanız --no-open parametresini kullanın.

Mümkün olduğunda bağlayıcı sırlarını komut satırında doğrudan iletmekten kaçının. Env (Çevre Değişkeni), stdin ve dosya tabanlı girdiler, kabuk geçmişinde ve işlem listelerinde açığa çıkmayı azaltır.

Çalışma Zamanı Durumunu İnceleme

chainabit connectors instances list --scope personal
chainabit connectors instances get inst_123
chainabit connectors instances update inst_123 --name "Team Slack" --enabled
chainabit connectors test inst_123
chainabit connectors tools inst_123 --locale tr

connectors tools, yürütebileceğiniz araç kimliklerini gösterir. Güncel CLI'da connector çalıştırma geçmişi için bir komut yoktur; tamamlanan bir çağrıyı incelemeniz gerektiğinde connectors exec sonucunu veya ürün arayüzünü kullanın.

Bir Aracı Çalıştırma

chainabit connectors exec inst_123 list_channels \
  --input '{"limit":20}'

connectors exec, araç anahtarını veya connectors tools tarafından gösterilen araç kimliğini kabul eder.

connectors exec yalnızca onay gerektirmeyen araçları çalıştırır. Slack send_message gibi onay gerektiren bir araç 403 ve connector_tool_approval_required hata koduyla reddedilir ve harici hizmete hiçbir şey gönderilmez. Bunun yerine aracı Chao'dan çalıştırmasını isteyin; Chao işlem yapmadan önce onay kurallarını uygular.

Dinamik Bağlayıcıları Senkronize Etme

chainabit connectors sync inst_123

Dinamik bir MCP tarzı bağlayıcıya bağlandıktan sonra sync komutunu kullanın, böylece CLI ve API araç listesini yenileyebilir.

JSON Komut Dosyası

chainabit connectors list --json | jq '.[0].key'
chainabit connectors tools inst_123 --json

Önerilen İş Akışı

1. chainabit connectors list
2. chainabit connectors install <key>
3. chainabit connectors auth <instance-id>
4. chainabit connectors test <instance-id>
5. chainabit connectors tools <instance-id>
6. chainabit connectors exec <instance-id> <tool> --input '<json>'

İlgili API Sözleşmeleri

• install, instances ve test komutlarının arkasındaki istek ve yanıt DTO'ları için Bağlayıcı Örnekleri API'sini (EN) kullanın.
• tools ve sync tarafından döndürülen şemalar için Bağlayıcı Araçları API'sini (EN) kullanın.
• connectors exec komutunun arkasındaki girdi ve çıktı sözleşmesi için Araç Çalıştırma API'sini (EN) kullanın.