Ana içeriğe geç

AI araçları

AI araçları, Wiz çalışırken sizin için belirli bir işi yapar: bugün Web araması (bilgi bankanızda cevap yoksa Wiz web'de arar) ve Görsel Stüdyosu (müşterinin gönderdiği fotoğraf stilize, çerçeveli bir portreye dönüşür). Her aracın kendi anahtarı, kendi sağlayıcıları, kendi limitleri ve kendi geçmişi vardır.

Ayarlar → AI → AI araçları'nı açın. Planınızın içerdiği ve yönetebildiğiniz (AI yönetimi yetkisi) araçları görürsünüz. Her aracın altında bugün nerede çalıştığı — örneğin Wiz, cevap yazarken, Görsel Stüdyosu için Gelen fotoğraflar, Web widget ve API — ve Yakında başlığından sonra ileride ulaşacağı yerler (akışlar, sesli asistan…) yazar.

Bir aracın çalışması için iki şart var: planınız onu içermeli ve aracın kendi Aç anahtarı açık olmalı.

Ayarlar​

Bir araçta Ayarla'ya tıklayın. Ayarlar sekmesinde:

  • Aç — çalışma alanının anahtarı.
  • Kimin anahtarı — Platform anahtarı (bizim anahtarlarımızla çalışır, ücreti cüzdanınızdan düşer) ya da Kendi anahtarım (kendi sağlayıcı hesabınız).
  • Sağlayıcı sırası — aracın kullanabileceği sağlayıcılar ve modeller, sırasıyla. İlki cevap verir; hata verirse ya da gecikirse sıradaki denenir. Aracın desteklediği her modeli ekleyebilir, yukarı-aşağı taşıyabilir ya da kaldırabilirsiniz. Tek bir modele bağlı değilsiniz: Görsel Stüdyosu'nda Magnific, Google Gemini, fal.ai ve OpenAI'ın görsel modelleri; web aramasında Serper, Tavily, Brave, SerpApi, SearchApi ve Google Programmable Search var. Platform anahtarında platformun o an sunmadığı sağlayıcı Platform anahtarında yok — atlanır diye işaretlenir.
  • Anahtarlarınız (Kendi anahtarım seçiliyken) — sıradaki her sağlayıcı için Ayarlar → Kimlik bilgileri'nde kaydettiğiniz bir anahtarı seçin. Yalnızca doğru türdeki anahtarlar ve yalnızca adları görünür — anahtarın kendisi asla.
  • Kanallar — aracın cevap verebileceği yerler. Hiçbiri seçilmezse aracın desteklediği tüm kanallar.
  • Limitler — kişi başına günlük, çalışma alanı başına dakikalık ya da günlük, aynı anda kaç tane. 0 limit yok demektir.
  • Davranış — örneğin Sonucu kontrol et, Cüzdan bakiyesi şart, Bir kişi devraldığında sessiz kal ya da web aramasında Sorunun yazımını düzelt.
  • Otomatik silme — müşterinin fotoğrafı ve sonuç kaç gün sonra silinsin. Boş ya da 0: süresiz saklanır — konuşmada, web widget'ında ve API'de aynı. Burada ya da bir profilde bir sayı ayarlamadıkça hiçbir şey otomatik silinmez; kişinin verilerinin silinmesi talebi yine de onları kaldırır.

Kaydet yalnızca değiştirdiklerinizi gönderir.

Profiller: etkinlikler ve kampanyalar​

Profil, bir aracın tek bir kullanım senaryosudur — bir etkinlik, bir kampanya, bir fuar standı — ve sizin düzenlediğiniz bir veridir, bizim sizin için yazdığımız bir kod değil. Bir çalışma alanında aynı anda birçok profil çalışabilir: bir ayda yirmi farklı etkinlik, yirmi profildir.

Profiller sekmesinde: Yeni profil, düzenle (kalem) ya da sil (çöp kutusu). Bir profilde şunlar var:

  • Ad, bir kısa kod (bağlantılarda kullanılır, sonradan değişmez), Durum (etkin ya da duraklatıldı), Öncelik (birden çok profil uyarsa büyük sayı kazanır), Başlangıç ve Bitiş, ve Kanallar.
  • Tetik — Anahtar kelimeler: bunlardan biriyle başlayan mesaj konuşmayı bu profile bağlar; örneğin WhatsApp'ı kelime yazılı açan bir QR kod. Yalnız anahtar kelimeden sonra, profilin yalnızca önce anahtar kelime gönderenlere cevap vermesini sağlar.
  • Görünüm — tema, stil varyantları ve vurgular. Bir varyant gruplar (group ya da min_people/max_people) veya kalabalıklar (crowd) için işaretlenebilir: grup fotoğrafı herkesi koruyan bir grup stili alır; en fazla kişi sınırının üstünde (kalabalık sınırına kadar) en iyi çabayla bir kalabalık stili, sonuç yazısına da kalabalık notu eklenir. Daha büyük kalabalıklardan daha küçük bir grup istenir.
  • Çerçeve — medya kütüphanesinden kendi PNG çerçeveniz ya da sizin sözcükleriniz ve renklerinizle bizim çizdiğimiz bir çerçeve:
    • Şerit — altta başlık, alt başlık, marka ve ad satırlı renkli bir bant.
    • Marka şeridi — fotoğraf öne çıkar: fotoğrafın altındaki yumuşak gölgenin üzerinde, ana renginizdeki bir etikette kişinin adı ve başlık; altında şerit renginizde bir zemin üzerinde logonuz, ince bir ayraç, alt başlık (etkinlik), bir ayrıntı satırı (tarih · yer) ve küçük bir imza satırı. Köşe vurgusu, şeridin sağ alt köşesine ana ve ikinci renginizde kavisli bir kama ekler; hiçbir yazı ona değmez.
    • Minimal kilit — fotoğraf tüm resmi kaplar; yalnız bir kenarda (Kilit konumu: alt ya da üst — yüzden uzak tutun) yumuşak bir gölge üzerinde logonuz ve başlık tek bir kilit olarak durur (Kilit biçimi: logo başlığın üstünde ya da logo | ayraç | başlık), o kenarın köşesinde de küçücük bir imza logosu. Ad satırı isteğe bağlı. Her portrede aynı kilit. Güvenli alan (genişlik, yükseklik, konum) her şeyi tek bir biçimin içinde tutar: 1080 × 1920 hikâye çıktısında üstte 1080 × 1350 güvenli alanla alt kesilince tam bir 4:5 gönderi kalır; sağlayıcılardan da yapabildikleri yerde dikey 9:16 görsel istenir.
    • Logo — logo dosyalarınızın medya kütüphanesi kimlikleri: açık zemin için bir tane ve varsa koyu zemin için ters (beyaz) sürümü; çerçeve şerit rengine uyanı seçer. Logo yüksekliği ve Logo boşluğu marka kılavuzunuza göre (boşsa otomatik). Logo okunamazsa portre yine gider, logosuz.
    • Uzun adlar önce küçülür, sonra iki satıra bölünür — asla kesilmez.
  • Çıktı — boyut ve dosya biçimi.
  • Onay — fotoğraf bir AI servisine gönderilmeden önce Onay iste, ve metin sürümü başına bir kez mi her seferinde mi sorulacağı. Sahibi hayır diyen fotoğraf asla kullanılmaz.
  • Web widget ve API — sitenizdeki ziyaretçilerin ve kendi uygulamanızın bu profili kullanıp kullanamayacağı (ikisi de siz açana kadar kapalı; aşağıya bakın).
  • Otomatik silme — bu profil için aracın ayarını ezer.
  • Ezmeler — bu profile özel sağlayıcı sırası ya da limitler.
  • Metinler — aracın gönderdiği her cümle (karşılama, onay sorusu ve düğmeleri, ret metinleri, sonuç yazısı…), istediğiniz kadar dilde. Boş alan gri görünen metni kullanır.

Silinen profilin geçmiş çalıştırmaları kayıtlarda kalır.

Stand ekranında​

Bir canlı akış panosu AI portreleri gösteriyorsa ziyaretçiye portresinin stand ekranında görünüp görünemeyeceği de sorulur — yalnızca o zaman ve yalnızca konuşma kanallarında (widget'ta ve API'de değil). Soru, düğme etiketleri, cevaplar ve ekrandan kaldır anahtar kelimeleri profilin screen_consent_question, screen_consent_yes, screen_consent_no, screen_consent_reply_hint, screen_consent_yes_ack, screen_consent_no_ack, screen_revoke_keywords (virgülle ayrılmış) ve screen_revoked metinleridir; diğerleri gibi dil başına düzenlenir.

Web widget'ınızda​

Bir profil, sitenizdeki sohbet widget'ının içinde kendi küçük ekranıyla görünebilir. Profili düzenleyin ve Web widget altında:

  • Web widget'ında göster — açıkken profil ziyaretçilere sunulur. Siz açana kadar kapalıdır, profil profil.
  • Widget simgesi — widget'taki düğmesinin simgesi.
  • Yalnız bu sitelerde — magaza.ornek.com gibi alan adları; alan adı ve tüm alt alan adları için *.ornek.com. Boş: widget'ınızın çalıştığı her site.
  • Sonucu ziyaretçinin sohbetine de ekle — varsayılan kapalı. Açıkken biten sonuç ziyaretçinin widget konuşmasına da eklenir: ekibiniz gelen kutusunda, ziyaretçi sohbette görür; o konuşmadaki diğer dosyalar gibi saklanır ve silinir. Yalnız sonuç eklenir, fotoğraf asla. Konuşması olmayan API'ye uygulanmaz.

Metinler altında Widget: düğme etiketi ve Widget: kısa açıklama widget'taki adını verir. Ziyaretçinin kabul ettiği onay metni yukarıdaki anahtarı izler; böylece olandan fazlasını ya da azını vaat etmez:

  • Ekleme kapalı: Onay sorusu (widget ve API, sonuç sohbete eklenmiyor); boşsa konuşma hakkında hiçbir şey vaat etmeyen varsayılan metin.
  • Ekleme açık: Onay sorusu (widget, sonuç sohbete ekleniyor); boşsa kendi (konuşma) Onay sorunuz, o da boşsa sonucun sohbette saklandığını söyleyen varsayılan metin.

Ziyaretçinin gördüğü: mesaj kutusunun üstündeki sırada yeni bir düğme (birden çok profil varsa seçim listesi) → sizin onay metniniz ve iki düğmeniz → Fotoğraf çek (telefonda kamera) ya da Fotoğraf seç, profilin stilleri varsa bir stil ya da Sürpriz yap → Oluştur → çalışırken sizin bekleme metniniz → İndir düğmesiyle sonuç, ya da sizin ret metniniz (fotoğrafta kişi yok, günlük hak doldu…). Ziyaretçi onaylamadan hiçbir şey yüklenmez; siz açmadıkça sohbete hiçbir şey yazılmaz.

Bir konuşmadaki limitler, cüzdan, acil durdurma ve otomatik silme burada da geçerlidir. Ayrıca ziyaretçinin canlı bir sohbet oturumu olmalı; bir oturum, bir ağ adresi ve tüm widget kısa sürede yalnızca birkaç çalıştırma başlatabilir.

Kendi uygulamanızdan (API)​

Kendi uygulamanız ya da sunucunuz da bir profili çalıştırabilir — örneğin standınızdaki bir fotoğraf kabini uygulaması. Profili düzenleyip API altında API üzerinden izin ver'i açın. Sonra Ayarlar → Geliştirici → API anahtarları'nda bir anahtar oluşturup AI araçlarını çalıştır (tools:run) kapsamını işaretleyin — ya da kapsamı var olan bir anahtarınıza ekleyin; belirteci değişmez. Geliştiriciniz çağrıları ve bir örneği AI araçları API'si başvurusunda bulur. Aynı Idempotency-Key ile yeniden denenen çağrı ikinci bir çalıştırma başlatmaz, ücretlendirmez.

API çalıştırmalarının konuşması yoktur; widget'ın "sohbete ekle" anahtarı onlara uygulanmaz.

Uygulamanızdan gelen çalıştırma kişi için sizin kendi referansınızı (örneğin kullanıcı kimliğiniz) taşır; kişi başına günlük limit bu referansa göre sayılır. Uygulamanız profilin onay metnini göstermeli ve sürümünü geri göndermelidir — kişinin kabul ettiğini böyle onaylar. tool_run.completed olayına bir webhook abone ederseniz sonuç hazır olduğunda sunucunuza haber verilir.

Son çalıştırmalar​

Son çalıştırmalar sekmesi son çalıştırmaları listeler: zaman, durum, hangi sağlayıcının cevap verdiği, kanal (ya da Web widget / API) ve maliyet. Yalnızca okunur. Web araması yalnızca hangi motorun cevap verdiğini ve kaç sonuç geldiğini kaydeder — müşterinin ne sorduğunu asla.

Test​

Web araması gibi denenebilen araçlarda bir Test sekmesi var: bir sorgu yazıp Çalıştır'a basın. Kayıtlı ayarlarla bir kez çalışır; gerçek bir çağrıdır ve öyle ücretlendirilir.

Bilgi bankanızda bir soru için bir şey yoksa Wiz web'de arar ve sonuçlardan cevap verir. Web araması eskiden Ayarlar → AI asistanı'nın bir sekmesiydi; o sekme artık sizi buraya getiriyor ve ayarlarınız değişmeden taşındı — aynı motor, aynı anahtar, aynı anahtarlar. Motor anahtarınızı eski ekrana doğrudan yazdıysanız, artık Ayarlar → Kimlik bilgileri'nde Web araması anahtarı — <motor> adıyla görünür.

Telefonda​

Menü → AI eğitimi → AI araçları'nı açın. Her aracın anahtarı, Kimin anahtarı, sağlayıcı sırası (ekle, kaldır, yukarı-aşağı taşı), her sağlayıcının anahtarı, kanallar, limitler, davranış, otomatik silme, varsa test, profilleri ve son çalıştırmaları orada. Profiller telefonda, sunuldukları yerde Web widget ve API yazarak listelenir; Profilleri web'de oluştur ya da düzenle bu sayfayı tarayıcıda açar, çünkü bir profilin metinleri, çerçevesi ve stilleri masa başında daha rahat yazılır. Her sağlayıcının altındaki Anahtar ekle o sağlayıcı için yeni bir anahtar saklar ve sizi o anahtar seçilmiş olarak geri getirir (Kimlik bilgileri).