Özel konektörler

Hangi deneyimi kullanıyorsunuz?

Bu belgeler her iki deneyimi de kapsar. Settings → Personal → My Okou kullanılabiliyorsa, My Okou adımlarını izleyin. New agent içeren bir Agents sayfası kullanıyorsanız, Legacy Agents adımlarını izleyin. Kullanılabilirlik üyeler arasında değişebilir; bu belgeler deneyiminizi değiştirmez.

Her iki deneyimde de birden fazla sohbeti veya görevi aynı anda çalıştırabilir, iş akışlarını yeniden kullanabilir ve gözden geçirilmiş çalışmayı ekibinizle paylaşabilirsiniz. Çalışma zamanı alt aracı, oluşturmanız gereken ayrı bir ürün profili değil, bir yürütme aracıdır.

Kurulum farklılıkları: My Okou, Settings → Personal → My Okou içindeki kişisel Instructions ve çalışma alanı Workflows kullanır. Aşağıda seçme, oluşturma veya yetkilendirme istenen herhangi bir adlandırılmış Aracı ile ilgili adım yalnızca Legacy Agents için geçerlidir. My Okou’da kendi sohbetinizi kullanın ve gösterilen hesap ile adlandırılmış izin isteğini izleyin. Paylaşılan Workflows kimlik bilgilerini paylaşmaz; Automations, sahibinin bağlamını ve erişimini kullanır.

Özel bir konektör, kuruluş yöneticisinin yerleşik katalogda olmayan bir HTTPS API’yi veya etkinleştirildiği durumlarda Streamable HTTP MCP sunucusunu kaydetmesine olanak tanır. Ağ sınırını ve kimlik doğrulama yöntemini tanımlar. Agent için otomatik olarak tam bir API başvurusu oluşturmaz.

Kim neyi yapılandırır

• Kuruluş yöneticileri konektör tanımını oluşturur, düzenler ve siler.
• Üyeler kendi gizli bilgilerini bağlar veya konektörün OAuth akışını tamamlar.
• Yetkilendirme ve izinler, Okou’nun bağlantıyla hangi adlandırılmış eylemleri isteyebileceğini kontrol eder. Legacy Agents ayrıca aracıya özgü yetkilendirme kullanır.

Tanım kuruluş içinde paylaşılır. Üye kimlik bilgileri üye ve kuruluş kapsamıyla sınırlı kalır.

HTTP API konektörü

1. Connectors → Custom bölümünü açın ve New connector seçin.
2. HTTP API seçin ve bir görünen ad girin.
3. Bir veya daha fazla HTTPS Prefixes ekleyin; her satıra bir tane. Bir isteğin konektörün onu yetkilendirmesinden önce yapılandırılmış bir önekle eşleşmesi gerekir.
4. API gerekiyorsa kimlik doğrulama ekleyin:
   • API authentication: üst bilgi adını ve {{secret}} içeren bir üst bilgi şablonunu girin; örneğin Authorization ve Bearer {{secret}}.
   • OAuth 2.0: yetkilendirme URL’sini, token URL’sini, istemci kimliğini, istemci gizli anahtarını, kapsamları ve token-uç noktası kimlik doğrulama yöntemini girin. Formda gösterilen tam yönlendirme URL’sini sağlayıcıya kaydedin.
5. Konektörü oluşturun. Buna ihtiyaç duyan her üye ardından Connect seçer ve gizli bilgisini sağlar ya da OAuth’u tamamlar.
6. Gerekli adlandırılmış izinleri gözden geçirin ve yetkilendirin. Legacy Agents’ta, ayrıca amaçlanan aracıyı seçin.

Var olan bir OAuth tanımını veya istemci kimlik bilgilerini değiştirmek, mevcut OAuth bağlantılarını koparır. Üyelerin değişiklikten sonra yeniden bağlanması gerekir.

MCP konektörü

İş 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çim listesinde sunulmuyorsa bu iş alanı için etkinleştirilmemiştir.

Agent’a API prosedürünü öğretin

Özel bir konektör, güvenli ağ erişimi ve kimlik bilgisi ekleme sağlar. Oluşturma formu bir OpenAPI belgesi yüklemez veya otomatik olarak bulmaz. Aracıya istekte uç noktayı, yöntemi, parametreleri ve beklenen yanıtı verin ya da bu prosedürü, dosya olarak eklenmiş bir API başvurusu bulunan bir workflow içinde kaydedin.

Yeni bir konektörü, bilinen bir uç noktaya yapılan dar kapsamlı, salt okunur bir istekle doğrulayın. Genel bir Test connection isteği yoktur; çünkü birçok API anlamlı bir kök uç nokta sunmaz.

Güvenlik sınırları

• Yalnızca HTTPS önekleri ve MCP uç noktaları kabul edilir.
• Güvenlik duvarı, kaydedilmiş kimlik bilgisini yalnızca eşleşen isteklere ekler.
• Kaydedilen gizli bilgi at-rest durumda şifrelenir ve bir ortam değişkeni olarak aracıya sunulmaz.
• Anahtarları, token’ları veya istemci gizli anahtarlarını sohbet mesajlarına, workflow talimatlarına ya da eklenmiş dosyalara koymayın.
• Workflow’un ihtiyaç duyduğu en az yukarı akış kapsamlarına sahip bir hizmet kimlik bilgisi kullanın.

Sorun giderme

Sonraki adım

• Yinelenen özel konektör işlerini yakalamak için İş Akışları bölümüne bakın.
• Özel konektör kimlik bilgilerinin nasıl işlendiğini görmek için İzinler bölümüne bakın.
• Özel bir çözüm geliştirmeden önce Catalog bölümüne bakın — hizmetiniz zaten destekleniyor olabilir.