- Botpress 'teki Kodu Çalıştır Kartı, bot iş akışları içinde özel JavaScript çalıştırmanıza olanak tanıyarak dinamik API çağrıları, veri işleme ve standart yerleşik eylemlerin ötesinde kişiselleştirilmiş mantık sağlar.
- Temel kullanım alanları arasında dinamik API istekleri, LLM çıktılarının sonradan işlenmesi, hız sınırlaması, izin kontrolleri ve çok adımlı API çağrılarının zincirlenmesi yer alıyor ve yapay zeka aracılarının karmaşık iş akışlarını hassasiyetle ele almasını sağlıyor.
- En iyi uygulamalar arasında API anahtarlarını ortam değişkenlerinde güvence altına almak, hataları ve zaman aşımlarını incelikle ele almak ve sağlam, güvenli bot işlemleri için koşullu mantık oluşturmak yer alır.
Yapay zeka ajanları yalnızca erişebildikleri veriler kadar güçlüdür. Büyük dil modelleriLLMsler) eğitim verilerinden yanıtlar üretirken, API'lerle entegre edilmedikleri sürece gerçek zamanlı hisse senedi fiyatlarını alamaz, ödemeleri işleyemez veya CRM ayrıntılarına erişemezler.
API'ler yapay zeka aracılarının gerçek zamanlı verilere erişmesini, mantık yürütmesini ve eylemleri tetiklemesini sağlar. Bunlardan tam olarak yararlanmak için aracıların özel koda ihtiyacı vardır.
Botpress Studio 'daki 'Kodu Çalıştır' Kartı, bir botun iş akışı içinde JavaScript yazmanıza ve çalıştırmanıza olanak tanır - API çağrılarını, veri işlemeyi ve bot davranışını özelleştirmeyi sorunsuz bir şekilde ele alır.
Kod Yürütme Kartı nedir?
Botpress 'teki Kodu Çalıştır Kartı, geliştiricilere botun akışı içinde özel JavaScript çalıştırma yetkisi verir. Aşağıdaki işlevleri etkinleştirir:
- Özel Mantık Uygulaması: Karmaşık hesaplamaları yürütebilir veya verileri standart eylemlerin kapsamadığı şekillerde dönüştürebilirsiniz.
- Dinamik Etkileşimler: Kullanıcı verilerine veya gerçek zamanlı hesaplamalara göre yanıtları ayarlayın.
- Veri Entegrasyonları: Veri almak veya göndermek için üçüncü taraf hizmetlerle sorunsuz bir şekilde bağlantı kurun.
- Durum Yönetimi: Bağlamı korumak ve etkileşimleri kişiselleştirmek için botun durumuna erişin ve değiştirin.
- Hata İşleme: Sağlam işlemler sağlamak için özel hata yönetimi uygulayın.
Kod Yürütme Kartı, yapay zeka tarafından oluşturulan kod önerilerine sahiptir. API verilerini almak gibi bir komut girin ve sistem anında JavaScript üretsin. Daha sonra kodu gözden geçirebilir, düzenleyebilir ve gerektiği gibi geliştirebilirsiniz.
Yapay Zeka Aracıları Neden Harici API'lere İhtiyaç Duyar?
Yapay zeka ajanları yalnızca eriştikleri veri ve hizmetler kadar kullanışlıdır. Girdileri işleyebilseler ve yanıtlar oluşturabilseler de , gerçek zamanlı bilgi, işlem yetenekleri ve harici API'ler olmadan derin entegrasyonlardan yoksundurlar.
İster gerçek zamanlı verileri entegre ediyor, ister iş akışlarını otomatikleştiriyor veya güvenliği artırıyor olun, API'ler botunuzu daha akıllı, duyarlı ve entegre hale getirir.
Kod Yürütme Kartını Kullanmanın 5 Yolu
Botpress Studio 'daki Execute Code Card, yapay zeka aracı işlemlerini kolaylaştırır. İş akışınıza eklemek basittir - bu hızlı öğreticiyi izleyin:
Eklendiktensonra, aracı iş akışınızda ondan yararlanmanın temel yollarını burada bulabilirsiniz.
1. Dinamik API Çağrıları
Statik API çağrıları kullanmak yerine Execute Card, istekleri kullanıcı amacına, bot bağlamına veya önceki konuşmalara göre dinamik olarak değiştirmenize olanak tanır.
Örnek: Kullanıcı tercihlerine göre özel veri getirme.
İstem: Bir seyahat sohbet botunun kullanıcının varış noktasına, seyahat tarihlerine ve bütçesine göre otel fiyatlarını alması gerekiyor.
.webp)
Not: Kod Yürütme Kartı doğal dilden kod üretebilir. Bununla birlikte, her zaman değişkenler iş akışını üretime dağıtmadan önce oluşturulan kodunuzda kullanılır.
2. LLM Yanıtları Üzerinde Sonradan İşleme
Botpress yerleşik yapay zeka eylemleri sunsa da, bazen çıktıları biçimlendirmek, belirli kelimeleri filtrelemek veya verileri daha net bir şekilde yapılandırmak gibi yanıtları kullanıcılara göstermeden önce ince ayar yapmanız gerekebilir.
Örnek: Yapılandırılmamış LLM yanıtlarının tanımlanmış bir tabloya/formata yeniden yazılması.
İpucu: Yapay zeka bir API'den restoran önerileri alıyor ve bunları görüntülemeden önce temiz bir tablo halinde biçimlendirmenizi istiyorum.
.webp)
3. Hız Sınırlayıcı ve Koşullu Yürütme
Dijital cüzdanlar da dahil olmak üzere bazı API'lerin kullanım sınırları vardır. Execute Code Card ile, oran sınırlarını zorlayarak, geri dönüşler ayarlayarak ve API kullanılabilirliğine dayalı koşullu mantık ekleyerek kullanıcı etkileşimlerini kontrol edebilirsiniz.
Örnek: Çağırmadan Önce API Kullanımını Kontrol Etme
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. İzinlerin İşlenmesi
Botpressbelirli özelliklere erişim izni vermeden önce kullanıcıları doğrulaması gerekiyorsa, kart Botpress'in varsayılan seçeneklerinin ötesine geçen özel kimlik doğrulama akışlarına izin verir.
Örnek: AI Yanıtları Vermeden Önce Kullanıcı Abonelik Durumunu Kontrol Etme
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Çok Adımlı API Zincirleme
Bazen bir botun nihai bir yanıt göndermeden önce birden fazla API'den gelen verileri birleştirmesi gerekir. Kart, verileri dinamik olarak getirerek, dönüştürerek ve aktararak karmaşık çok adımlı iş akışlarına olanak tanır.
Örnek: Ayrılmak İçin En İyi Zamanı Önermek Üzere Hava Durumu + Restoran Rezervasyonu Getirme
Prompt: workflow.userApiKey kullanarak workflow.city için hava durumu ve trafik verilerini getirin. Koşullara bağlı olarak en iyi seyahat süresini döndür. Hataları ele alın.
.webp)
Yapay Zeka Ajanları için Sorunsuz API Entegrasyonları
Yapay zeka aracıları, gerçek zamanlı verilere erişebildiklerinde, iş akışlarını otomatikleştirebildiklerinde ve harici hizmetlerle bağlantı kurabildiklerinde en iyi şekilde çalışır.
Botpress Hub , önceden oluşturulmuş API entegrasyonları, otomasyon araçları ve kullanıma hazır bağlayıcılarla bunu sorunsuz hale getirir; böylece yapılandırmaya değil oluşturmaya odaklanabilirsiniz.
Güçlü API'leri botunuzun iş akışlarınaentegre etmeye bugün başlayın; hem de ücretsiz.
SSS
1. Kod Yürütme Kartını etkin bir şekilde kullanmak için JavaScript bilmem gerekiyor mu?
Şart değil. Temel bilgileri bilmek yardımcı olur, ancak kart yapay zeka tarafından oluşturulan kod önerileri içerir. Sadece ne istediğinizi tarif edebilirsiniz, o da sizin için bazı başlangıç kodları yazacaktır.
2. Yaygın API entegrasyonları için şablonlar veya şablon kod parçacıkları var mı?
Evet, Botpress hava durumu API'lerini, CRM'leri veya ödeme hizmetlerini çağırmak gibi popüler kullanım durumları için örnekler ve topluluk tarafından paylaşılan snippet'ler sağlar.
3. Kod Yürütme Kartını önceden API entegrasyon deneyimi olmadan kullanabilir miyim?
Kesinlikle. API'ler konusunda yeniyseniz, kartın yerleşik yapay zekası sizi yönlendirmelerle yönlendirebilir ve görsel iş akışı oluşturucu tüm süreci daha sezgisel hale getirir.
4. Kart, uzun süren API isteklerini veya zaman aşımlarını nasıl ele alıyor?
Await ile asenkron JavaScript'i destekler, ancak işleri sorunsuz tutmak için try/catch ve fallback mantığını kullanarak zaman aşımı işlemini manuel olarak oluşturmak isteyeceksiniz.
5. Kart kullanarak kimlik doğrulama ve yetkilendirmeyi uygulamak için en iyi uygulamalar nelerdir?
Hassas anahtarları ortam değişkenlerinde güvenli bir şekilde saklayın, API yetkilendirmesi için belirteçler veya üstbilgiler kullanın ve devam etmeden önce kullanıcı rollerini veya erişim düzeylerini kontrol etmek için kodunuza koşullu mantık ekleyin.
