Brave Web Search aksiyonu, Brave arama motorunun genel web arama özelliğini kullanarak kullanıcıların belirledikleri sorgulara uygun web sonuçlarını döndürmesini sağlar. Bu sonuçlar; başlık, açıklama ve URL bilgilerini içerir. Özellikle bilgi sorgulama, içerik entegrasyonu, analiz ve araştırma odaklı uygulamalarda tercih edilir.

Teknik Özellikler

Arama İşlemi (Search Paneli): Brave Web Search aksiyonu, girilen anahtar kelimeler doğrultusunda web üzerindeki içerikleri listeler. Sonuçlar çoklu kayıt (Many) şeklinde döner.

Parametreler:

• settings (Object – zorunlu): Brave API ayarlarının tanımlandığı Configuration Manager nesnesidir.
• query (String – zorunlu): Aranacak kelime veya ifade. (Ör. “climate change report”, “best mobile apps 2025”, “Kuika low-code platform”).
• count (Int32 – zorunlu): Döndürülecek sonuç sayısını belirtir. 0 verilirse sonuç dönmez.
• offset (Int32 – opsiyonel): Sayfalama için kullanılır. Kaçıncı sonuçtan itibaren döneceğini belirtir. (Örn. 10 girilirse, 11. sonuçtan itibaren listeler).

Veri Kaynağı Uyumluluğu: Tüm parametreler sabit (Fixed) değer olarak tanımlanabileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da bağlanabilir.

Web & Mobil Destek: Brave Web Search aksiyonu, hem web hem de mobil uygulamalarda çalışır.

Brave Web Search Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülünde web sonuçlarının gösterileceği ekranı seçin.
• Bir Text Input (arama kutusu) ve Button (ör. “Web’de Ara”) elementi ekleyin.
• Butona tıklayın ve + ADD ACTION → Brave Search → Brave Web Search aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da tanımlanmış Brave API ayarını seçin.
• query: Text Input’a bağlanacak şekilde ayarlayın (kullanıcı ne yazarsa o aransın).
• count: Döndürülecek sonuç sayısını belirleyin (örn. 10).
• offset: Eğer sayfalama gerekiyorsa 0 yerine uygun başlangıç değeri girin.

Kullanım Senaryosu: Kuika Hakkında Web Sonuçlarını Çekme

Bir bilgi uygulamasında kullanıcı “Kuika platform” yazarak web sonuçlarını görmek ister.

Adımlar:

1. Text Input ekleyin (örn. “Arama”).
2. “Ara” butonuna OnClick → Brave Web Search aksiyonu ekleyin.
3. Query parametresini Text Input’a bağlayın.
4. Count değerini 10 yapın.
5. Dönen sonuçları Table elementi ile başlık, açıklama ve URL olarak gösterin.

Brave Web Search İleri Seviye Özelleştirmeler

• Sayfalama (Pagination): offset parametresi ile “Sonraki Sayfa” butonu eklenebilir.
• Koşullu Gösterim: Eğer sonuç bulunamazsa “Sonuç bulunamadı” mesajı gösterilebilir.
• Sonuçların Kaydedilmesi: Kullanıcı arama geçmişini kaydedebilir.
• Bağlantı ile Açma: Dönen URL’ler tıklanarak kullanıcı direkt kaynağa yönlendirilebilir.

Teknik Riskler ve Kontroller

• query boş olmamalıdır. Zorunlu parametredir, aksi durumda sonuç dönmez.
• count = 0 verilirse sonuç alınmaz. Minimum 1 veya daha yüksek değer girilmelidir.
• offset yanlış verilirse beklenenden farklı sayfalama sonuçları dönebilir.
• settings ayarı zorunludur. Configuration Manager’da Brave Web Search için ayar yapılmazsa aksiyon çalışmaz.
• Sonuç Formatı: Dönen sonuçlarda başlık, açıklama ve link alanlarının doğru bağlanması gerekir.