Screens

Bazı yanıtlar kullanıcının zaten sahip olduğu bir ekranda sonlanır: sipariş, abonelik, bildirim ayarları. Oraya nasıl gidileceğini tarif etmek yerine Rendel, bunu bir screens kartında veya bir butonda sunabilir ve bir dokunuş, uygulamanızın kendi navigasyonu aracılığıyla bu ekranı açar. Hiçbir şey bir web view değildir ve yeni hiçbir şey inşa edilmez: zaten sahip olduğunuz bir ekranı kaydedersiniz ve ne zaman doğru ekran olduğunu belirtirsiniz.

Bir ekran, bir aksiyon değildir. Açılması hiçbir şeyi değiştirmez; bu nedenle hiçbir zaman bir onay kartına ihtiyaç duymaz; kullanıcı ne için geldiyse onu kendi ekranınızda tamamlar.

Bir ekran kaydetme

Yapay zekâ kodlama aracınız, siz istediğinizde registerRoute ile bir ekran kaydeder (Bir ekran ekleme); bu çağrı Flutter SDK ve Web SDK referanslarında yer alır. Bir ekran şunlardan oluşur:

Bir uygulama en fazla 50 ekran kaydeder. Her iki çağrı da init öncesinde güvenlidir; ekranlar, aksiyonlarınızla birlikte manifest içinde taşınır. Ekranınız gösterilirken Rendel köşedeki küçük bir baloncukta bekler (bubbleOffset onu kendi alt çubuğunuzun üzerinde tutar) ve balona dokunulduğunda yanıtı olduğu gibi geri getirir.

Zaten bir rotası veya deep link'i olan ekranları tercih edin; diyalogları, onboarding'i ve girişi atlayın. Kullanıcının adıyla asla istemeyeceği bir ekran, modelin seçimlerinde gürültü yaratır.

fromActions: modelin uyduramayacağı değerler

fromActions: true olarak işaretlenen bir parametre, bu sohbette aksiyonlarınızdan birinin döndürdüğü bir değere eşit olmalıdır. order_detail ekranını açan sipariş kimliği, önce get_order veya list_orders çağrısından dönmüş olmalıdır. Modelin uydurduğu, bir bilgi kaynağında okuduğu veya kullanıcıdan duyduğu bir kimlik ekranı açmaz ve kart metin haline geri döner.

Bunu bir şeyi tanımlayan her parametre için kullanın: bir sipariş, bir rezervasyon, bir hesap, bir tutar. Ayarlar sekmesi adı gibi ne olursa olsun güvenli olan değerler için kapalı bırakın.

Bir yanıt sunucudan ayrılmadan önce, içindeki her navigate kayıtlı ekranlarınıza göre kontrol edilir: ekran mevcut olmalı, parametreleri bildirdiği parametreler olmalı, kendi tiplerinde olmalı, zorunlu olanlar bulunmalı ve fromActions olanlar bir aksiyon sonucuna kadar izlenebilmelidir. Bkz. Sunucunun kontrol ettiği değerler.

Screens sayfası

Yönetim panelinin Screens sayfası, en son derlemesinden itibaren uygulamanızın ne kaydettiğini listeler:

• Kayıtlı: en son derlemede, başlık, açıklama ve parametreler derlemenin tanımladığı şekliyle yer alır. Bir aksiyondan olarak işaretlenmiş bir parametre bunu belirtir.
• Planlandı, henüz kaydedilmedi: bir yapay zekâ kodlama aracının kodda yazdığını belirttiği, ancak şimdiye kadar hiçbir derlemenin kaydetmediği ekranlar. Bunları kaydeden bir derleme çalıştığında yukarı taşınırlar. Biri burada kalıyorsa registerRoute çağrısı başlangıçta çalışmıyordur.
• En son derlemenizde yok: daha önceki bir derleme bunları kaydetmiştir ve en son derleme kaydetmemiştir. Hâlâ o derlemede olan cihazlar bunları açabilir.

Bir ekranın ne sıklıkla açıldığı

Screens sayfası açılmaları sayar: bir kullanıcının bir ekran kartına veya bir yanıtta kayıtlı rotalarınızdan birini açan herhangi bir kontrole dokunması ve rotanın açılması. Her ekran; son 30 gün boyunca üst bilginin ayarlandığı anahtarda kaç kez açıldığını, bunu sunan yanıtların ne kadarından açıldığını (oranı) ve en son ne zaman açıldığını gösterir. Bunun altında, asistanın bunu ne sıklıkla sunduğu ve talep ettiği bir ekranı sunucunun ne sıklıkla reddettiği yer alır.

SDK (Flutter 0.46.5, web 0.23.6 ve üzeri), bir açılmayı rotanın adı, yanıt ve geldiği kart ile birlikte gönderir; ekranın ne gösterdiğine dair hiçbir şey iletilmez. Açılmaları her ekip üyesi görebilir; yanıtlardan okunan teklifleri ise yalnızca sohbetleri okuyan roller görebilir.

Bir ekranı kapatma

Kayıtlı her ekranın bir anahtarı vardır. Kapatın; Rendel yeni bir sürüm gerektirmeden, her derlemede bu ekranı sunmayı hemen durdurur. Uygulamanız değişmez: kullanıcılar ekranı kendileri açmaya devam edebilir. Aynı şekilde tekrar açın.

Bu, bir aksiyonu devre dışı bırakmakla aynı mantıktır: kodunuzun kaydettiği şey Rendel'in yapabileceği en üst sınırdır ve yönetim paneli bunu istediği zaman daraltabilir.

Bir ekranı deneme

Test sayfasında veya eşleştirilmiş bir derlemede bunu isteyin: “son siparişimi göster”, siparişin kartıyla birlikte geri gelmelidir. Rendel bunun yerine sözcüklerle yanıt verirse ekranın description alanını netleştirin — kullanıcılarınızın kullandığı sözcüklerle, ne zaman doğru ekran olduğunu belirtin.