Entegrasyonları kullanma

Bu rehber, entegrasyonları ajanlarda nasıl kullanacağınızı gösterir. Google Calendar entegrasyonu örneğini kullanıyoruz; ancak adımlar ve dikkat edilecekler diğer tüm ajan veya özel entegrasyonlar için geçerlidir.

Yapılandırma editörü

Entegrasyonu kullanabilmesi gereken bir ajan oluşturun. Create agente tıkladığınızda Ajan oluşturucu sohbeti açılır. Yapılandırma editörünü açmak için Go to editore tıklayın veya oluşturucunun ajanı kurmasına izin verip editörü sohbetin yanında açın. Harika ajanlar oluşturma hakkında daha fazla bilgi için ajan oluşturma rehberini kullanabilirsiniz.

Aksiyon ekleme

Yapılandırma editöründe artık çalışma alanınızda etkinleştirilmiş entegrasyonların aksiyonlarını ekleyebilirsiniz.

İstediğiniz aksiyonu arayıp seçin ve bireysel bağlantı veya önceden seçilmiş bağlantı seçerek ajanınıza ekleyin.

Bireysel bağlantılar, kendi hesabınızı (bu örnekte Google Calendar) bağlamanıza ve ajanın sizin erişim haklarınız, kaynaklarınız ve kısıtlarınızla hareket etmesine olanak tanır. Bu, bir aksiyon ilk tetiklendiğinde veya entegrasyonlar menüsü üzerinden OAuth kimlik doğrulaması gerektirir. OAuth sırasında ajanın kullanmasını istediğiniz hesabı seçin ve ajan'ın istediği erişime izin verin.

Önceden seçilmiş bağlantılar, bu aksiyonu kullanırken bu ajanın tüm kullanıcıları tarafından seçilebilir; bu nedenle burada erişim kurallarına dikkat edin.

Aksiyonu ekledikten sonra yürütülmesinin onayınızı gerektirip gerektirmediğini veya otomatik tetiklenip tetiklenemeyeceğini seçebilirsiniz. Onay etkinse ajan her zaman aksiyonu ve girdi parametrelerini yürütmeden önce size gösterir.

Aksiyonları kullanma

Artık entegrasyonları ajanınızda kullanabilirsiniz. Ajan, aksiyonları konuşma bağlamına göre otomatik tetikler. Bir ajanın birçok aksiyonu varsa, hepsini bir kerede değerlendirmek yerine önce isteğinizle ilgili olanları arar. Bu, sohbette kısa bir "Searching for tools" adımı olarak görünür. Bir aksiyon onay gerektiriyorsa girdi parametreleriyle spesifik isteği görürsünüz. E-posta gövdeleri gibi uygun zengin metin girdileri için işlenmiş içeriği gözden geçirmek üzere Preview'ı, altta yatan HTML veya Markdown'ı incelemek üzere Source'u kullanın. Preview harici görüntüleri veya özel stilleri göstermez. Alıcının e-posta istemcisi gönderilen içeriği farklı işleyebilir. "Confirm"e basmak aksiyonu tetikler.

Kullanılabilirlik önerileri

Bir ajana aksiyon ekleme

Bir ajana aksiyon eklerken cömert olun. Bazı entegrasyonların HubSpot'un Get deal context'i gibi bağlam toplama aksiyonları vardır; bu, pipeline ve aşamalar için dahili kimlikleri alır. Bu, Create deal veya Update deal gibi aksiyonların daha akıcı kullanılmasını sağlar; çünkü HubSpot ayarlarınızda kimlik aramak yerine ajandan mevcut tüm pipeline'ları almasını isteyebilir ve hangisini kullanacağınızı doğal dilde belirtebilirsiniz.

Onay gerektiren aksiyonlar

Varsayılan olarak tüm aksiyonlar onay gerektirir. Aksiyon türüne göre yapılandırma önerimiz:

Onay gerekmez: Bilgi toplayan, indiren, arayan veya okuyan aksiyonlar. Bu, minimum riskle daha hızlı bilgi toplamaya olanak tanır.

Onay önerilir: Nesne oluşturan, güncelleyen veya silen aksiyonlar. Bu, yürütmeden önce model tarafından üretilen parametreleri doğrulamanızı sağlar.

SSS

ajan'ın harici araçlardaki bilgilere erişmesi veya bunlar üzerinde işlem yapması gerektiğinde entegrasyonları kullanın. Entegrasyonlar şirket verisi almak, aksiyon tetiklemek, kayıtları güncellemek veya ajanları ve iş akışlarını araç yığınınıza bağlamak için kullanışlıdır.

Bağlantıyı, izinleri, OAuth kapsamlarını, etkin aksiyonları ve bağlı hesabın harici araçta istenen kaynağa erişip erişemediğini kontrol edin. Entegrasyon bir kullanıcı için çalışıp diğeri için çalışmıyorsa izinlerini karşılaştırın.