Bağlantılar

Bağlantılar nedir?

Bir bağlantı, ajan ile harici bir araç arasında kaydedilmiş bir kimlik doğrulama bağlantısıdır. Google Calendar, HubSpot veya başka herhangi bir entegrasyonu bağladığınızda, o hizmetle etkileşim için gereken kimlik bilgilerini saklayan bir bağlantı oluşturursunuz.

Her bağlantı onu oluşturan kullanıcıya aittir. Bu, kimlik bilgilerinizin güvenli kalmasını ve eylemlerin sizin erişim haklarınızla gerçekleştirilmesini sağlar.

Kimlik doğrulama türleri

ajan, entegrasyona bağlı olarak farklı kimlik doğrulama yöntemlerini destekler:

OAuth kimlik doğrulama

Çoğu popüler entegrasyon, güvenli yetkilendirme için endüstri standardı protokol olan OAuth kullanır. OAuth ile bağlandığınızda:

1. Yönlendirilirsiniz hizmetin giriş sayfasına (ör. Google, Microsoft)
2. Kendi hesabınızla giriş yaparsınız
3. ajan'ın belirli verilere erişmesi için izin verirsiniz
4. Token'lar güvenli saklanır ve otomatik yenilenir

Varsayılan olarak ajan'ın OAuth istemcisi yetkilendirilmiş izinler ister. Bunlar oturum açmış kullanıcı adına hareket eder; böylece her bağlantı o kullanıcının kendi erişim haklarını kullanır.

Workspace yöneticiniz tüm Workspace veya belirli gruplar için özel OAuth istemcileri yapılandırabilir. Bir bağlantı oluşturduğunuzda eşleşen bir grup istemcisi Workspace istemcisine göre önceliklidir. Bağlantınız, grup üyeliğiniz daha sonra değişse bile kurulum sırasında seçilen istemciye bağlı kalır.

Hesabınızla eşleşen aktif istemci yoksa veya iki aktif grup istemcisi üyeliklerinizle eşleşiyorsa ajan bağlantıyı oluşturamaz. İstemci veya grup atamalarını güncellemek için Workspace yöneticinizle iletişime geçin.

Bir OAuth bağlantısı süresi dolarsa, iptal edilirse veya gerekli bir kapsam eksikse ajan yeniden yetkilendirmenizi ister. Kurtarma adımları için OAuth bağlantılarını yeniden yetkilendirme.

OAuth bağlantıları her zaman sizin izinlerinizle hareket eder. Google'da bir takvime erişemiyorsanız, bağlantınızı kullanan ajan da erişemez.

Özel kapsamlar ve uygulama düzeyinde izinler

Kendi OAuth istemcinizi kurarsanız, ajan varsayılanlarının ötesinde özel kapsamlar isteyebilirsiniz; bireysel bir kullanıcıya bağlı olmayan geniş erişim veren uygulama düzeyinde izinler dahil. Kurulum için Kendi OAuth istemcinizi getirin.

Uygulama düzeyinde izinler herhangi bir kullanıcının erişim haklarından bağımsız hareket eder ve kuruluşunuz genelinde verilere ulaşabilir. Bunları yalnızca belirli bir entegrasyon gerektirdiğinde verin.

OAuth bağlantılarını yeniden yetkilendirme

ajan, bir OAuth bağlantısının süresi dolduğunda, iptal edildiğinde, çalışmayı durdurduğunda, bir eylemin ihtiyaç duyduğu bir kapsam eksik olduğunda veya özel OAuth istemcisi bir Workspace yöneticisi tarafından kaldırıldığında yeniden yetkilendirmenizi ister.

Bir Workspace yöneticisi bağlantınızın kullandığı özel OAuth istemcisini silerse, hizmet bağlantının erişim token'ını reddedene kadar bağlantı çalışmaya devam eder. Eylemler ardından yeniden yetkilendirene kadar bir kimlik doğrulama hatasıyla başarısız olur. Yeniden yetkilendirme, yeni bir bağlantı oluşturmakla aynı şekilde bir istemci seçer.

Sohbette başarısız bir eylem Yeniden yetkilendir istemi gösterebilir. Bağlantıyı güncellemek için Yeniden yetkilendir'e tıklayın. OAuth bağlantıları için ajan düzenli OAuth akışını başlatır. Bağlantı güncellendikten sonra ajan uygun başarısız istekleri otomatik yeniden deneyebilir.

Bir OAuth bağlantısını elle yeniden yetkilendirmek için:

1. Entegrasyonlar'a gidin.
2. Dikkat gerektiren bağlantıya sahip entegrasyonu açın.
3. Bağlantının eylemler menüsünü açın ve Yeniden yetkilendir'i seçin.
4. Bağlantıya sahip olması gereken hesapla giriş yapın ve istenen kapsamları onaylayın.

Geçersiz bir bağlantı kullanan aktif iş akışları, sonraki bir çalıştırma başarısız olmadan önce İzle altında Yeniden bağlanacak iş akışlarında da görünür. Satırda İncele'ye tıklayın. Bağlantının sahibi sizseniz diyalogda Yeniden bağlan'a tıklayın.

API Key ve Service Account kimlik doğrulama

Bu kimlik doğrulama türleri kimlik bilgilerini elle sağlamanızı gerektirir:

• API Key: Hizmetin ayarlarından bir API anahtarı kopyalayıp ajan'a yapıştırın
• Service Account: Hizmet hesabı kimlik bilgileri sağlayın (genellikle bir JSON dosyası veya anahtar çifti)

Bunlar tipik olarak OAuth desteklemeyen hizmetler veya daha geniş erişim gerektiren yönetici düzeyinde entegrasyonlar için kullanılır.

---

Bağlantı sahipliği

Varsayılan olarak bağlantılar kullanıcı tabanlıdır ve paylaşılabilir değildir. Bu şu anlama gelir:

• Yalnızca oluşturduğunuz bağlantıları görebilir ve kullanabilirsiniz
• Gerçekleştirilen eylemler sizin erişim haklarınızı ve izinlerinizi kullanır
• Kimlik bilgileriniz diğer kullanıcılara asla açıklanmaz
• Diğer kullanıcılar OAuth bağlantılarınızı doğrudan kullanamaz

Bu tasarım güvenlik ve uyumluluğu sağlar — yetkilendirmeniz size aittir.

Neden kullanıcı tabanlı?

ajan'ın Google Calendar'ınıza erişmesine izin verdiğinizde, eylemlerin sizin adınıza gerçekleştirilmesi için izin vermiş olursunuz. Bu bağlantıyı başkalarıyla paylaşmak, OAuth onayı sırasında kurulan güven ilişkisini ihlal ederek sizin adınıza hareket edebilecekleri anlamına gelir.

---

Varsayılan bağlantı ayarlama

Aynı entegrasyona birden fazla bağlantınız varsa (örneğin kişisel bir Google hesabı ve iş Google hesabı), birini varsayılan olarak işaretleyebilirsiniz. ajan ardından bir ajan veya iş akışı o entegrasyona ihtiyaç duyduğunda ve belirli bir bağlantı önceden seçilmediğinde varsayılan bağlantınızı otomatik kullanır.

Varsayılan bağlantıyı ne zaman kullanmalısınız?

• Aynı hizmete birden fazla bağlantı tutuyor ve birinin varsayılan kullanılmasını istiyorsunuz.
• İş akışlarını veya ajanları ekip arkadaşlarıyla paylaşıyor ve önceden seçilmiş biri yapılandırılmadığında onların varsayılan bağlantınıza düşmesini istiyorsunuz.
• Her eylem çalıştığında bir bağlantı seçmeniz istenmesinden kaçınmak istiyorsunuz.

Bir varsayılan entegrasyon ve kullanıcı başına geçerlidir. Her kişi kendi varsayılanını seçer ve bir ajan üzerindeki önceden seçilmiş bağlantı her zaman önceliklidir.

Varsayılan bağlantı nasıl ayarlanır?

1. Entegrasyonlar'a gidin ve yapılandırmak istediğiniz entegrasyonu açın.
2. Varsayılan olarak kullanmak istediğiniz bağlantıyı Bağlantılarınız veya Paylaşılan bağlantılar altında bulun.
3. Bağlantının eylemler menüsünü açın ve Varsayılan olarak ayarla'yı seçin.

Bağlantı bir Varsayılan etiketiyle işaretlenir. Varsayılanınızı değiştirmek için başka bir bağlantıyı varsayılan olarak ayarlayın; temizlemek için eylemler menüsünü yeniden açın ve Varsayılanı kaldır'ı seçin.

Varsayılanlar nasıl uygulanır?

Bir eylem çalıştığında ajan bir bağlantıyı şu sırayla seçer:

1. Varsa ajan veya eylem üzerinde yapılandırılmış önceden seçilmiş bağlantı.
2. Ayarladıysanız o entegrasyon için varsayılan bağlantınız.
3. Size kullanılabilir olanlardan bir bağlantı seçmenizi isteyen bir istem.

Bir Workspace API anahtarı bir kişinin varsayılan bağlantısını kullanmaz. Bağlantıyı o anahtarla paylaşın veya ajan üzerinde önceden seçin.

---

Ajan eylemlerinde paylaşılan bağlantıları kullanma

Bağlantılar varsayılan olarak kişisel kalır. Başka kişilerin seçili bir bağlantıyla bir entegrasyon eylemi çalıştırmasına izin vermek için bağlantıyı bir ajandaki o eyleme ekleyin.

Önceden seçilmiş bağlantıyı entegrasyon sayfasından değil, ajan editöründe yapılandırın. Diğer kişiler bağlantıya doğrudan erişim almaz. Yalnızca paylaşılan ajan üzerinden o eylemi çalıştırdıklarında kullanabilirler.

Bir ajan eylemi için önceden seçilmiş bağlantı nasıl yapılandırılır?

1. Kenar çubuğunda Ajanlar'a gidin ve bir ajan açın veya oluşturun.
2. Eylemler'de Eylem ekle'ye tıklayın ve entegrasyon eylemini seçin.
3. Hayır, tüm kullanıcılar aynı, önceden seçilmiş bağlantıyı kullanmalı'yı seçin.
4. Bağlantıyı seçin ve Eylem ekle'ye tıklayın.
5. Ajanı yayınlayın ve eylemi çalıştırması gereken kişilerle paylaşın.

Ajanı kullanan kişiler kimlik bilgilerini görmeden o eylemi önceden seçilmiş bağlantıyla çalıştırabilir.

Nasıl çalışır?

Bir ajana eylem eklediğinizde kimlik doğrulamanın nasıl çalışacağını seçersiniz:

1. "Kendi kimlik bilgileri" (varsayılan) — Ajanı kullanan her kullanıcı kendi hesabıyla kimlik doğrular. Henüz bağlamadıysa bağlanması istenir.
2. "Önceden seçilmiş bağlantı" (gelişmiş) — Tüm kullanıcıların kullanacağı belirli bir bağlantıyı seçersiniz. Bir OAuth bağlantısını önceden seçmek için OAuth bağlantılarını paylaş iznine ihtiyacınız vardır.

Önceden seçilmiş bir bağlantı kullanıldığında tüm kullanıcılar — kendi hesaplarından bağımsız olarak — o bağlantının kimlik bilgileriyle eylem gerçekleştirir.

Kullanım senaryoları

Varsayılan mod (kendi kimlik bilgileri):

• Her ekip üyesi kendi Google Calendar'ını bağlar
• Eylemler kendi takvimlerinde görünür
• Kimlik bilgisi paylaşımı gerekmez

Önceden seçilmiş bağlantı modu:

• Herkesin gönderdiği paylaşılan bir ekip takvimi
• Tüm satış temsilcileri için merkezi bir CRM hesabı
• Bir şirket Slack bot hesabı

Örnek: Paylaşılan bir ekip takvimine önceden seçilmiş bağlantıyla bir "Ekip Takvimi Ajanı" oluşturursunuz. Herhangi bir meslektaş bu ajanı kullandığında etkinlik ekip takviminde oluşturulur — ancak takvimin kimlik bilgilerini asla görmezler.

---

OAuth olmayan bağlantıları doğrudan paylaşma

API Key, Service Account veya No Authentication kullanan bağlantılar diğer kullanıcılar, gruplar, Workspace API anahtarları veya tüm Workspace ile doğrudan paylaşılabilir.

Authorization: Basic (base64-encoded) kullanan MCP bağlantıları API Key bağlantıları olarak sayılır.

Paylaşılabilir bağlantı türleri

OAuth neden doğrudan paylaşılamaz?

OAuth token'ları belirli bir kullanıcının yetkilendirmesini ve onayını temsil eder. Bunları paylaşmak:

• Kullanıcının hizmet sağlayıcıyla anlaşmasını ihlal eder
• Token'lar sızdırılırsa güvenlik riskleri oluşturur
• Hangi eylemi kimin gerçekleştirdiğini izlemeyi imkânsız kılar

OAuth olmayan bağlantılar nasıl paylaşılır?

Workspace yöneticileri entegrasyon sayfasından API Key bağlantılarını ve diğer doğrudan paylaşılabilir bağlantı türlerini paylaşabilir:

1. Entegrasyonlar'a gidin
2. Bağlantınızın bulunduğu entegrasyonu seçin
3. Bağlantının eylemler menüsünü açın ve Bağlantıyı paylaş'ı seçin
4. Kiminle paylaşacağınızı seçin:
   • Belirli kullanıcılar: Bireysel ekip üyeleri
   • Gruplar: Tüm ekipler veya departmanlar
   • Workspace API anahtarları: Hizmet hesaplarına ait anahtarlar
   • Tüm Workspace: Workspace'teki herkes

Workspace API anahtarlarını ada göre arayın. Yalnızca Workspace'inizdeki aktif, süresi dolmamış anahtarlar görünür. Mevcut yetkiler anahtar adını gösterir. Aktif anahtarlar Workspace API anahtarı etiketini gösterirken süresi dolmuş, iptal edilmiş ve bilinmeyen anahtarlar durumlarını gösterir. Bunları aynı paylaşım diyaloğundan kaldırabilirsiniz.

Bir ajanı Workspace API anahtarıyla çağırırsanız bağlantıyı o anahtarla paylaşın veya ajan üzerinde önceden seçin. Anahtar oluşturucunun kişisel bağlantılarını kullanmaz.

Bağlantı kartının kendisi paylaşım ayarlarını açmaz. Bağlantıyı paylaş eylemler menüsünde görünmezse bir ajan üzerinde önceden seçilmiş bir bağlantı kullanın veya bir Workspace yöneticisinden bağlantıyı doğrudan paylaşmasını isteyin.

Bu, tüm ekibin kullanabilmesi gereken çeviri hizmetleri, analitik araçlar veya dahili API'ler gibi paylaşılan API anahtarları için harikadır.

Bağlantıları kim paylaşabilir?

---

Doğru paylaşım yöntemini seçme

---

Özet

Bağlantıların nasıl çalıştığını anlamak güvenli, işbirlikçi iş akışları oluşturmanıza yardımcı olur. OAuth bağlantıları için ajan tabanlı paylaşımı; uygun olduğunda API anahtarları ve hizmet hesapları için doğrudan paylaşımı kullanın.

SSS

Bir bağlantı, entegrasyona ve paylaşım yapılandırmasına bağlı olarak onu oluşturan kullanıcıya veya Workspace kurulumuna bağlıdır. Bir ajan, sohbet veya iş akışı bağlı bir aracı kullanamıyorsa önce gerekli bağlantının o bağlam için kullanılabilir olup olmadığını ve doğru kullanıcının erişim verip vermediğini kontrol edin.

Bağlantılar entegrasyonun kullanıldığı her yerde kullanılabilir olmalıdır. Bir sohbette veya bir kullanıcı için çalışan bir bağlantı başka bir kullanıcıya, ajana veya iş akışına otomatik kullanılabilir olmayabilir. Entegrasyonun paylaşım ayarlarını, bağlı hesabı ve eylemin hedef ajan veya iş akışı için etkin olup olmadığını kontrol edin.

Bir entegrasyon, OAuth bağlantısının süresi dolduğunda, iptal edildiğinde, çalışmayı durdurduğunda, bir kapsam eksik olduğunda veya bir Workspace yöneticisinin kaldırdığı özel bir OAuth istemcisi kullandığında yeniden bağlanmanızı ister. Sohbetten, Entegrasyonlar'dan veya İzle altında Yeniden bağlanacak iş akışlarından yeniden yetkilendirin. Adımlar için OAuth bağlantılarını yeniden yetkilendirme.