Öznitelikler

ARCY'nin saklayabileceği öznitelikleri tanımlayın, listeyi tek dosya olarak alıp verin ya da kodlama ajanınızın önerdiklerini kabul edin; identify() değerlerinin ulaştığını görün.

Yapılandır > Öznitelikler, ARCY'nin saklamasına izin verilen özniteliklerin listesidir. Kodunuzun identify() ile gönderdiği ama burada tanımlı olmayan bir anahtar yok sayılır. Önce tanımlayın, sonra gönderin.

Başlamadan önce

Öznitelik tanımlama, düzenleme, içe aktarma, silme ve öneri kabul etme yetkisi kuruluş yöneticisindedir. Üyeler listeyi, durum rozetlerini ve Dışa aktar düğmesini görür. Durum rozetleri kenar çubuğunda seçili ortamı okur.

Kurulum

Yeni öznitelik düğmesine basıp alanları doldurun:

Görünen ad: panelde göreceğiniz ad. Sonradan değişebilir.
Kod adı: kodunuzun gönderdiği anahtar. Oluşturulduktan sonra kalıcıdır. Yalnızca küçük harf, rakam ve alt çizgi; harfle başlar, alt çizgiyle bitmez, en fazla 64 karakter. user_, organization_ ya da plan_ ön eki özniteliği o gruba yerleştirir.
Veri tipi: Metin, Sayı, Tarih/saat, Doğru/yanlış, Liste, Nesne ya da Nesne listesi. Tipi tutmayan değer dönüştürülmez, reddedilir. Sonradan değişebilir.
Açıklama: isteğe bağlı. Nesne için belgenin ne içerdiğini yazın; ARCY belgenin içine bakmaz.

Sonra anahtarı Yazılım ürününüzden gönderin (Hızlı başlangıç); ön yüzünüz göndermeden hiçbir profilde görünmez.

Öznitelik dosyası

Dışa aktar, sizin tanımladığınız özniteliklerin JSON dosyasını indirir; hazır öznitelikler dosyaya girmez. İçe aktar, henüz sahip olmadığınız her kod adını ekler. Zaten var olan bir kod adı atlanır ve olduğu gibi kalır. Kurala uymayan satır nedeniyle birlikte reddedilir; hatalı bir dosya bütün olarak reddedilir.

ARCY MCP ile ajanınıza devredin, ARCY MCP sayfasındaki Öznitelikleri tanımlayın maddesini açar. Ajanın önerdikleri burada Ajanınızın önerisi kartında soluk satırlar olarak görünür: Kabul et hepsini tanımlar, satırdaki Kabul et yalnızca o satırı tanımlar, At kalanları kaldırır.

Özniteliği düzenle görünen adı, açıklamayı ve sizin tanımladığınız bir öznitelikte veri tipini değiştirir. Özniteliği sil özniteliği arşivler: saklanan değerler durur, aynı kod adını yeniden tanımlayınca geri gelir. ARCY tarafından ayarlanır rozetli öznitelikleri ARCY kendisi hesaplar; identify() ile gelen değeri reddeder ve silinemez.

Neyi değiştirir

Tanımlı her öznitelik, ziyaretçilerin okuduğu metinlerde kullanılabilir: bir widget metni, bir akışın genel adı ya da adım sorusu, bir Persona alanı. Alanda {{ yazın ya da Öznitelik ekle düğmesine basın.

Nesne ve Nesne listesi bunun dışındadır. ARCY belgeyi bütün olarak saklar; bu iki tip yalnızca bir Persona alanına ulaşır, yalnızca dolu olup olmadığına göre filtrelenir ve bir raporu bölemez. Belgenin içindeki bir alana göre filtrelemek için o alanı ayrı bir öznitelik olarak gönderin. Her değer 10 KB, 5 düzey iç içe yapı, dizide 200 öğe ve nesnede 50 anahtarla sınırlıdır; bir profil en fazla 64 KB öznitelik taşır. Sınırı aşan değer reddedilir, yükün kalanı kabul edilir.

Her satır, seçili ortam için bir durum rozeti taşır:

Rozet	Anlamı
Hiç görülmedi	Bu anahtar için hiçbir değer gelmedi.
Geliyor ama reddediliyor	Şimdiye kadar gelen her değer reddedildi. Nedeni için üzerine gelin.
Geliyor, hiçbir şey saklanmadı	Anahtar geliyor ama güncel değer boş. Bir çağrı `null` göndererek değeri temizler.
Son görülme	Değerler geliyor ve saklanıyor.

Liste örnek değer saklamaz; yalnızca bir şeyin gelip gelmediğini ve kabul edilip edilmediğini tutar.

Sorun çıktığında

Her satırda Hiç görülmedi yazıyor. Yazılım ürününüz bu ortama henüz öznitelik göndermiyor. Token'ı ve identify() çağrısını Kurulum sayfasında kontrol edin.

Bir satırda Geliyor ama reddediliyor yazıyor. Neden rozetin ipucunda yazar: yanlış veri tipi, boyut sınırının üstü, ARCY'nin kendi hesapladığı bir anahtar, hazır kontrolden geçemeyen bir değer ya da tanımlanmadan önce gelmiş bir anahtar. Değeri kodunuzda düzeltin ya da veri tipini burada değiştirin.

Reddedilen anahtar için profilin tamamı gösteriliyor. Profil 64 KB öznitelik sınırına ulaştı. Saklanan hiçbir değer silinmedi; daha az gönderin ya da belge yerine özet gönderin.