Akışlar

Akış, ARCY'nin bir kullanıcı için yazılım ürününüzün içinde, sohbet üzerinden yürüttüğü adım dizisidir. Akışları Yapılandır > Akışlar sayfasında kurar ve yayınlarsınız.

Başlamadan önce

• Çalıştığınız ortama atanmış, doğrulanmış bir domain gerekir. Bakınız Domainler.
• arcy.js yazılım ürününüzde en az bir kez görülmüş olmalıdır; aksi hâlde oluşturucu öğe hedefleyemez. Bakınız Hızlı başlangıç.
• Kaç akış tutabileceğinizi planınız belirler. Sınıra ulaşınca Akış oluştur devre dışı kalır. Bakınız Faturalandırma.
• İstek adımı için Endpoint'ler sayfasında kayıtlı bir endpoint gerekir.

Kurulum

Akış oluştur yalnızca ekibinizin göreceği bir Ad ister.

ARCY MCP ile ajanınıza devredin. Kodlama ajanınız her akış için bir ad ve bir cümleden yola çıkarak taslakları yazar, siz inceleyip yayınlarsınız. Rehberi aç, ARCY MCP sayfasını açar.

Adımlar. Ne yapar listesinde sekiz tür vardır: Tıkla, Doldur, Yönlendir (/settings/team gibi bir yol ya da tam bir https:// adres), İpucu, Söyle, Sor, İstek ve Topla. Bir akış en fazla 30 adım tutar.

Öğeyi seçmek. Tıkla, Doldur ve İpucu adımlarında Öğe seç, adını verdiğiniz sayfayı yeni bir sekmede seçici açık olarak getirir; orada öğeye tıklayın. Eşleştirme ayarını ARCY hiçbir şey bulamıyorsa gevşetin, yanlış öğeyi buluyorsa sıkılaştırın. Tarih seçici ve "Sepette 3 kalem" gibi etiketler için Bu öğenin metni değişken seçeneğini açın. Açık bir pencerenin ya da menünün arkasındaki öğe hiçbir zaman eşleşmez. Seçici, captcha'yı ve başka bir sitenin çerçevesi içindeki öğeleri reddeder ve sebebini yazar.

Doldur adımları. Adımın kutusundaki rozet, ARCY'nin kullanacağı denetimi adlandırır. Seçilen öğenin erişilebilirlik rolü yoksa Şöyle davran listesi her türü ve Bunu kullanıcıya bırak seçeneğini sunar. ARCY seçiminizi doğrulamadan uygular; Önizle ile kontrol edin. Değer, değerin nereden geleceğini belirler. Kişiye sor, Sohbette sorulacak soru metnini kelimesi kelimesine gösterir; tam bir cümle yazın. Yanıt ya da özellik, Öznitelik ekle ile seçilen tek bir referans alır; Sabit değer olduğu gibi yazılır. Dosya yükleme ve ARCY'nin kullanamadığı her denetim kullanıcıya bırakılır. Beklenen girdi türü (isteğe bağlı) uymayan yanıtı reddeder ve soruyu yeniden sorar.

İpucu adımları. Not metnini yazın (markdown çalışır), isterseniz bir Başlık ekleyin ve Konum seçin. Öğeye tıklamak İleri sayılır.

Söyle adımları. Mesaj sohbette ARCY olarak görünür; markdown çalışır, sohbet hakkı harcanmaz. Bir Hızlı Akış öner, başka bir akışı başlatan ve bu çalıştırmayı bitiren bir düğme ekler; yayında olmayan bir akış için düğme görünmez.

Sor adımları. Her zaman bir seçimdir: Soru ile iki ila altı Seçenekler düğme olarak görünür, dokunulan etiket yanıttır. Yazılı yanıta izin ver ve Birden fazla seçime izin ver adları gibi çalışır. Yanıtı bir özellik olarak kaydet, yanıtı özniteliklerinizden birine yazar: yazılı yanıt için metin türünde öznitelik gerekir, bir seçim metne ya da listeye sığar, salt okunur öznitelikler listelenmez.

Topla adımları. Soru sohbette görünür ve kullanıcı tek bir değer yazar. Yanıt türü (Metin, Sayı, E-posta, Tarih, URL, Telefon) karttaki alanı belirler ve uymayan yanıtı reddeder; aynı yanlış yanıt ikinci kez gelirse çalıştırma biter. Zorunlu açık gelir; kapatırsanız kart Atla düğmesi sunar ve yanıt boş kalır. Zaten biliniyorsa bir öznitelik seçer: öznitelik dolu ise soru hiç sorulmaz ve o değer yanıt olur, boş ise soru olduğu gibi kalır. Yanıtı bir özellik olarak kaydet yalnızca metin türünde öznitelikleri listeler. Adım adının altındaki gri satır, sonraki adımların bu yanıtı hangi adla okuyacağını gösterir; örneğin {{ answers.email }}.

İstek adımları. Uç nokta, Endpoint'ler sayfasındaki kayıtlardan birini seçer. Çağrı ziyaretçinin tarayıcısında yapılır ve yanıt gelene kadar sohbette bir çalışıyor satırı görünür; neyi taşıdığı Endpoint'ler sayfasında yazar. Girdiler altında her girdiyi Yanıt ya da özellik ya da Sabit değer olarak bağlayın; zorunlu girdilerin tamamı ayarlanmalıdır. Çağrı 10 saniye bekler.

Bu akıştaki yanıtlar. Her Sor, Topla ve Doldur yanıtı (parola hariç) ile her İstek yanıt alanı, sonraki adımlara ekleme seçicisinde Bu akıştaki yanıtlar altında {{ answers.company_name }} biçiminde sunulur: anahtar, adım adının küçük harfe çevrilip boşlukların alt çizgi yapılmış hâlidir. Yanıtlar yalnızca o çalıştırma boyunca yaşar ve akışın kendi telemetrisi dışında ARCY'ye ulaşmaz.

Tetikleyiciler. Bir adım, adım etkinken bir Koşul izleyen ve sonra Adıma git ya da Akışı kapat ile harekete geçen tetikleyiciler taşıyabilir; Hangi adım seçilmeden akış kaydedilmez. Koşullar VE ve VEYA ile birleşir. Bir soruya verilen yanıt ve İstek sonucu kaydedilmiş bir adım seçer; bu yüzden önce akışı kaydedin. İlki Sor ve Topla adımlarını birlikte listeler; boş ve boş değil işleçleri atlanmış bir sorunun etrafından dolaşır. Kontrol etmeden önce bekle (isteğe bağlı), işlemi en fazla 60 saniye geciktirir.

Akış ayarları. Anahtar, akışı panel dışından güncelleyen araçların kullandığı tanıtıcıdır: küçük harf, rakam, _ ve - içerir, en fazla 64 karakterdir, harfle başlar ve yazılım ürününüzde benzersizdir. Aynı anahtar ikinci bir akışa verilirse kayıt reddedilir. Herkese açık ad, ARCY akışı önerdiğinde kullanıcıların gördüğü addır; boş kalırsa akış kullanıcılara ulaşmaz. Özet, ajanın akışı ne zaman önereceğine karar verirken okuduğu metindir; kullanıcının kelimelerini kullanın. Hedef kitle, akışın kime ulaşacağını belirler. Öğe bekleme sınırı, bir adımın öğesini ne kadar bekleyeceğidir; en fazla 60 saniye, varsayılan 30.

Bitiş. Tek bir adımda Akışın sonu seçeneğini açın; açmazsanız son adım bitiştir.

İnceleme bekliyor. Adım paneli her adımı kimin yazdığını söyler. Bir ajanın yüzde 70'in altında güvenle yazdığı adım, öğesi, tetikleyici koşulu ya da zorunlu bir endpoint girdisi eksik olan adım, önceki hiçbir adımın toplamadığı bir yanıtı okuyan adım ve isteğe bağlı bir Topla yanıtını zorunlu bir girdiye bağlayan İstek adımı İnceleme bekliyor rozeti taşır: adımı açın, kontrol edin, İncelendi olarak işaretle düğmesine basın. Böyle bir adım kaldığı sürece Yayınla reddedilir.

Kaydet, Önizle, Yayınla. Kaydetmek için her adım tamamlanmış olmalıdır. Önizle, kaydedilmiş taslağı kendi sitenizde çalıştırır, analitiğe hiçbir şey yazmaz ve her kutuyu geçti ya da kaldı olarak işaretler. Yayınla, kaydedilmiş kopyayı tek seferde tek bir ortama gönderir.

Neyi değiştirir

Akışa kim ulaşır. Kullanıcı kimliği ve bize gönderdiğiniz en az bir özniteliği olan ziyaretçi kimliği doğrulanmış, diğerleri anonim sayılır. Herkes, Yalnızca tanımlanmış ve Yalnızca anonim tarafı seçer.

Yayınlama. Her ortam kendi kopyasını sunar: Hiç yayınlanmadı, Yayında, taslağınızdan eski bir kopya sunuyorsa Bekleyen değişiklik ya da Yayından kaldırıldı. Yayınlama o kopyanın üzerine yazar; sürüm geçmişi yoktur.

Ölçüm. Tıkla ve Doldur adımları ölçülür; Yönlendir adımı, kendi yazılım ürününüzde joker içermeyen bir sayfa açıyorsa ölçülür. Diğer beş tür ölçülmez; şemadaki kutularında Ölçülmez yazar. Kullanıcılar işi seçmediğiniz bir yoldan bitirebiliyorsa ayarlar panelinde Tamamlanma olayı seçin ya da yazın: huni, arcy.track() ya da Entegrasyonlar sayfasında kabul edilmiş bir araç bu adı gönderdiğinde biter. Listedeki akış satırı analizini açar: huni, her adımın nasıl bittiği, Topla adımında kaç kişinin yanıtladığı, atladığı ya da yanıtlamadan ayrıldığı, hatalar ve Akış desteğiyle ile Desteksiz karşılaştırması.

Silme. Sil, akışı, adımlarını ve hunisini kaldırır; yayındaki akışı önce her yerden yayından kaldırın.

Yapılacaklar. Yapılacaklar bölümü, bir ajanın Göster tetikleyicisinin sohbet çubuğuna koyduğu sıralı sonuç listelerini tutar; bir madde bu akışlardan birini çalıştırabilir. Bkz. Yapılacaklar.

Sorun çıktığında

• Bir adım öğesini bulamıyor. Bekleme süresi dolunca akış durur ve kullanıcı kısa bir özür görür. Akışın analizi sebebi ve çözümü kaydeder. Öğe bir pencerenin, menünün ya da sabit çubuğun arkasındaysa açık olanın içindeki öğeyi seçin ya da önce onu kapatan bir adım ekleyin. Eşleştirme ayarını gevşetmek işe yaramaz.
• İstek adımı çalıştırmayı bitiriyor. Endpoint 2xx dışında yanıt verdi ya da 10 saniye içinde yanıt vermedi; durum kodu akışın analizindedir. Endpoint'i düzeltin ya da İstek sonucu başarısız koşuluyla dallanın.
• Kaydınız reddedildi. Bu arada başkası akışı kaydetti. Gerekenleri kopyalayın, sonra Akışı yeniden yükle seçeneğini kullanın.
• Seçici sitenizi açıyor ama hiçbir şey gelmiyor. Yeni sekmeye geçin; ARCY sebebi oraya yazar. Olağan sebepler o sayfada arcy.js'in bulunmaması ya da cdn.arcyai.com adresini engelleyen bir Content-Security-Policy'dir.

Ayrıca bakın

• Yapılacaklar
• ARCY MCP
• Endpoint'ler