Özel konektörler

Özel bir konektör, bir organizasyon yöneticisinin yerleşik katalogda olmayan bir HTTPS API veya, etkinleştirildiğinde, bir Streamable HTTP MCP sunucusunu kaydetmesini sağlar. Ağ sınırını ve kimlik doğrulama yöntemini tanımlar. Ajan için otomatik olarak tam bir API referansı oluşturmaz.

Kim neyi yapılandırır

• Organizasyon yöneticileri konektör tanımını oluşturur, düzenler ve siler.
• Üyeler kendi gizli anahtarlarını bağlar veya konektörün OAuth akışını tamamlar.
• Ajan yetkilendirmesi hangi ajanların bağlı kimlik bilgisini kullanabileceğini ve hangi adlandırılmış izinleri alacaklarını kontrol eder.

Tanım organizasyonda paylaşılır. Üye kimlik bilgileri üye ve organizasyon ile sınırlı kalır.

HTTP API konektörü

1. Konektörler → Özel bölümünü açın ve Yeni konektör seçeneğini seçin.
2. HTTP API seçin ve bir görünen ad girin.
3. Bir veya daha fazla HTTPS Önek ekleyin, her satıra bir tane olacak şekilde. Bir isteğin yetkilendirilebilmesi için yapılandırılmış bir önek ile eşleşmesi gerekir.
4. API kimlik doğrulaması gerektiriyorsa kimlik doğrulama ekleyin:
   • API kimlik doğrulama: başlık adını ve {{secret}} içeren bir başlık şablonunu girin, örneğin Authorization ve Bearer {{secret}}.
   • OAuth 2.0: yetkilendirme URL'si, token URL'si, istemci kimliği, istemci gizli anahtarı, kapsamlar ve token uç nokta kimlik doğrulama yöntemini girin. Formda gösterilen tam yönlendirme URL'sini sağlayıcıya kaydedin.
5. Konektörü oluşturun. İhtiyacı olan her üye daha sonra Bağlan seçeneğini seçer ve kendi gizli anahtarını girer veya OAuth'u tamamlar.
6. Gerekli ajanı ve izinleri yetkilendirin.

Mevcut bir OAuth tanımını veya istemci kimlik bilgilerini değiştirmek, mevcut OAuth bağlantılarını keser. Değişiklikten sonra üyelerin tekrar bağlanması gerekir.

MCP konektörü

Çalışma alanınızda bir konektör türü olarak MCP görünüyorsa, bir HTTPS Streamable HTTP MCP uç noktası girin ve aynı formda API veya OAuth kimlik doğrulamasını yapılandırın. MCP seçicide sunulmuyorsa, o çalışma alanı için etkin değildir.

Ajana API prosedürünü öğretin

Özel bir konektör güvenli ağ erişimi ve kimlik bilgisi enjeksiyonu sağlar. Oluşturma formu bir OpenAPI belgesi yüklemez veya otomatik olarak keşfetmez. Ajan'a uç noktayı, yöntemi, parametreleri ve beklenen yanıtı istekte verin veya bu prosedürü bir iş akışında ekli bir API referansı dosyasıyla yakalayın.

Yeni bir konektörü, bilinen bir uç noktaya dar, salt okunur bir istekle doğrulayın. Birçok API anlamlı bir kök uç noktası sunmadığı için genel bir Bağlantıyı test et isteği yoktur.

Güvenlik sınırları

• Yalnızca HTTPS önekleri ve MCP uç noktaları kabul edilir.
• Güvenlik duvarı, kaydedilen kimlik bilgisini yalnızca eşleşen isteklere enjekte eder.
• Kaydedilen gizli anahtar dinlenirken şifrelenir ve ajana ortam değişkeni olarak gösterilmez.
• Anahtarları, tokenları veya istemci gizli anahtarlarını sohbet mesajlarında, iş akışı talimatlarında veya ekli dosyalarda paylaşmayın.
• İş akışının ihtiyaç duyduğu minimum üst akış kapsamlarına sahip bir hizmet kimlik bilgisi kullanın.

Sorun giderme

Sırada ne var

• Tekrarlanan özel konektör işlemlerini yakalamak için İş Akışları bölümüne bakın.
• Özel konektör kimlik bilgilerinin nasıl işlendiğini öğrenmek için İzinler bölümüne bakın.
• Özel oluşturmadan önce Katalog bölümüne göz atın — hizmetiniz zaten destekleniyor olabilir.