İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Form alanları

Sohbet başlamadan önce kullanıcılardan yapılandırılmış bilgi toplamak için ajanlarınıza form girdi alanları yapılandırın.

Formlar, belirli bilgileri önceden toplayarak kullanıcıları yönlendirir; böylece ajan yanıtları en başından daha doğru ve ilgili olur.

Genel bakış

Ajanınızın girdi türünü Form olarak ayarladığınızda, kullanıcıların sohbet etmeden önce doldurması gereken özel girdi alanları tanımlayabilirsiniz. Bu yapılandırılmış yaklaşım, ajanın her sohbet için tutarlı, iyi düzenlenmiş bilgi almasını sağlar.

Formlar şunlar için idealdir:

  • Kullanıcıların ajana bağlam sağlama biçimini standartlaştırmak
  • Gerekli tüm bilgilerin önceden yakalanmasını sağlamak
  • İleri geri netleştirme sorularını azaltmak
  • Belirli kullanım senaryoları için anket benzeri bir deneyim oluşturmak

Alan türleri

Her alan türü farklı bir amaca hizmet eder. Toplamanız gereken bilgilere göre doğru türü seçin.

Metin

Kısa yanıtlar için tek satırlı metin girdisi.

ÖzellikAçıklama
En uygunAdlar, başlıklar, kısa ifadeler, tanımlayıcılar

Örnek kullanım senaryoları:

  • Müşteri adı
  • Proje başlığı
  • Ürün SKU
  • Şirket adı

Çok satırlı metin

Daha uzun içerik için çok satırlı metin alanı.

ÖzellikAçıklama
En uygunAçıklamalar, geri bildirim, ayrıntılı bağlam

Örnek kullanım senaryoları:

  • Ayrıntılı sorun açıklamaları
  • Geri bildirim veya öneriler
  • Özetlenecek toplantı notları
  • Analiz edilecek veya yeniden yazılacak içerik

Sayı

Sayısal girdi alanı.

ÖzellikAçıklama
En uygunMiktarlar, tutarlar, skorlar, değerlendirmeler

Örnek kullanım senaryoları:

  • Bütçe tutarı
  • Katılımcı sayısı
  • Öncelik skoru (1–10)
  • Sipariş edilecek miktar

Onay kutusu

Evet/hayır seçimleri için boolean geçiş.

ÖzellikAçıklama
En uygunAnlaşmalar, tercihler, geçişler

Örnek kullanım senaryoları:

  • "Şartları kabul ediyorum"
  • "Ayrıntılı analiz dahil et"
  • "Acil işlem gerekli"
  • "E-posta bildirimi gönder"

Dosya

Belgeler, görseller, veri dosyaları ve videolar için dosya yükleme alanı.

ÖzellikAçıklama
En uygunBelgeler, görseller, veri dosyaları, videolar
Doğrulamaİsteğe bağlı dosya türü kısıtlamaları
LimitElle editörde bir Dosya alanı. Dosya alanları genelinde gönderim başına en fazla 50 dosya

Örnek kullanım senaryoları:

  • Analiz için özgeçmiş
  • Özetlenecek belge
  • Açıklama için görsel
  • İşleme için veri dosyası

Dosya alanları en fazla 100 MB desteklenen video dosyalarını kabul eder. Tüm desteklenen dosya türleri ve boyut limitleri için Desteklenen dosya türleri sayfasına bakın.

Seçim

Önceden tanımlı seçeneklerle açılır menü.

ÖzellikAçıklama
En uygunKategoriler, sabit listeden seçimler
DoğrulamaAlan zorunlu olduğunda kullanıcı bir seçenek seçmelidir

Örnek kullanım senaryoları:

  • Departman seçimi
  • Öncelik düzeyi (Düşük, Orta, Yüksek)
  • Dil tercihi
  • Ürün kategorisi

Çoklu seçim

Kullanıcıların birden fazla önceden tanımlı seçenek seçebildiği seçim alanı.

ÖzellikAçıklama
En uygunEtiketler, uygulanabilir kategoriler, birden fazla tercih
DoğrulamaAlan zorunlu olduğunda kullanıcı en az bir seçenek seçmelidir

Örnek kullanım senaryoları:

  • İlgili departmanlar
  • Tercih edilen iletişim kanalları
  • Uygulanabilir ürün kategorileri
  • Gerekli rapor bölümleri

Tarih

Belirli tarihler seçmek için tarih seçici.

ÖzellikAçıklama
En uygunSon tarihler, etkinlik tarihleri, zaman referansları
DoğrulamaStandart tarih biçimi

Örnek kullanım senaryoları:

  • Proje son tarihi
  • Etkinlik tarihi
  • Rapor dönemi
  • Toplantı tarihi

E-posta

Yerleşik biçim doğrulamalı e-posta adresi girdisi.

ÖzellikAçıklama
En uygunİletişim e-postaları, kullanıcı tanımlama, bildirim yönlendirme
DoğrulamaGeçerli bir e-posta adresi biçimi olmalıdır

Örnek kullanım senaryoları:

  • Müşteri iletişim e-postası
  • Bildirim alıcısı
  • Arama için hesap e-postası
  • Rapor teslim adresi

Alan özellikleri

Her alan, davranışını ve görünümünü kontrol eden ortak özellikleri paylaşır.

Ortak özellikler

ÖzellikAçıklamaZorunlu
AdKullanıcılara gösterilen görünen adEvet
Açıklama (isteğe bağlı)Ne girileceğini açıklayan yardım metniHayır
ZorunluAlanın doldurulmasının gerekip gerekmediğiHayır

Her Ad formda benzersiz olmalıdır. Yeni alanlar Zorunlu açık olarak başlar. Zorunlu, isteğe bağlı olarak kaydedilen Onay kutusu alanları için kullanılamaz.

Limitler

ÖzellikLimit
Elle yapılandırıldığında maksimum alan25
Agent Builder tarafından oluşturulan maksimum alan20
Alan adı255 karakter
Alan açıklaması512 karakter
Seçenek metni (API isteklerinde Seçim ve Çoklu seçim alanları için)255 karakter
Dosya türleri dizesi255 karakter

Türe özgü özellikler

Dosya:

ÖzellikAçıklama
Dosya türleriİzin verilen uzantıların virgülle ayrılmış listesi (ör. .pdf, .docx, .txt)

Seçim ve Çoklu seçim:

ÖzellikAçıklama
SeçeneklerKullanıcıların seçebileceği kullanılabilir seçeneklerin listesi

E-posta:

ÖzellikAçıklama
Alan adı kısıtlamasıKabul edilen adresleri belirli alan adlarıyla kısıtlayın. Birden fazla alan adını virgülle ayrılmış liste olarak girin (ör. ajan.com, example.com)

Form girdili ajan oluşturma

Form girdileri olan bir ajan oluşturmak için bu adımları izleyin. Alternatif olarak formu Agent Builder sohbetinde anlatın; alanları sizin için oluşturur.

Adım 1: Yeni ajan oluşturun

  1. Kenar çubuğunda Ajanlar'a gidin
  2. Ajan oluştur'a tıklayın. Agent Builder sohbeti açılır
  3. Yapılandırma editörünü açmak için Editöre git'e tıklayın
  4. Ajanınıza bir ad ve açıklama verin

Adım 2: Girdi türünü Form olarak ayarlayın

  1. Ajan yapılandırmasında Girdi türü'nü bulun
  2. Varsayılan Prompt seçeneği yerine Form'u seçin

Adım 3: Form alanları ekleyin

  1. Yeni bir girdi alanı oluşturmak için Girdi alanı ekle'ye tıklayın
  2. Açılır listeden alan türünü seçin
  3. Alan özelliklerini yapılandırın:
    • Net, açıklayıcı bir Ad girin
    • Gerekiyorsa Açıklama (isteğe bağlı) metni ekleyin
    • Zorunlu'yu açık bırakın veya kapatın. Zorunlu Onay kutusu için kullanılamaz
    • Türe özgü seçenekleri ayarlayın (Seçim ve Çoklu seçim alanları için seçenekler)
  4. İhtiyacınız olan her alan için tekrarlayın

Adım 4: Alanlarınızı sıralayın

Alanları mantıksal bir sıraya koymak için sürükleyip bırakın. En önemli veya bağlamsal olarak ilk alanları üste yerleştirin.

Adım 5: Talimatlar yazın

Ajanın Talimatlarında, toplanan bilgilerin nasıl kullanılacağını söylemek için form alanlarına atıfta bulunun:

You are a customer support specialist. Use the following information provided by the user:

- Customer Name: Use this to personalize your responses
- Issue Category: Focus your troubleshooting on this specific area
- Problem Description: Analyze this to understand the core issue
- Priority Level: Adjust your response urgency accordingly

Always address the customer by name and provide solutions relevant to their selected category.

Adım 6: Formunuzu test edin

  1. Formu önizlemek için Oluştur ve Test geçişini Test'e alın
  2. Formu bir kullanıcının yapacağı gibi doldurun
  3. Ajanın bilgiyi doğru aldığını ve kullandığını doğrulayın
  4. Gerekiyorsa alan adlarını veya talimatları ayarlayın
  5. İlk sürümü yayınlamak için üst çubukta Oluştur'a tıklayın

Örnek yapılandırmalar

Müşteri destek girişi

Fields:
1. Customer name (Text, required)
   - Name: "Your Name"

2. Email (Email, required)
   - Name: "Email Address"

3. Category (Select, required)
   - Name: "Issue Category"
   - Options: Billing, Technical, Account, Other

4. Description (Multi-line Text, required)
   - Name: "Describe Your Issue"
   - Description: "Please provide as much detail as possible"

5. Urgency (Select)
   - Name: "How urgent is this?"
   - Options: Low, Medium, High, Critical

Belge analizi

Fields:
1. Document (File, required)
   - Name: "Upload Document"
   - File Types: .pdf, .docx, .txt

2. Analysis Type (Select, required)
   - Name: "What type of analysis?"
   - Options: Summary, Key Points, Sentiment, Translation

3. Additional Context (Multi-line Text)
   - Name: "Any specific focus areas?"
   - Description: "Optional: Tell us what aspects to focus on"

Proje özeti oluşturucu

Fields:
1. Project Name (Text, required)
   - Name: "Project Name"

2. Objectives (Multi-line Text, required)
   - Name: "Project Objectives"
   - Description: "What are you trying to achieve?"

3. Budget (Number)
   - Name: "Budget (USD)"

4. Deadline (Date, required)
   - Name: "Target Completion Date"

5. Include Timeline (Checkbox)
   - Name: "Generate detailed timeline"

En iyi uygulamalar

Yalnızca ajanın gerçekten ihtiyaç duyduğu bilgileri isteyin. Her ek alan sürtünmeyi artırır ve kullanıcıların formu terk etme olasılığını yükseltir.

Etiketler hangi bilginin beklendiğini net biçimde belirtmelidir. Kullanıcıların anlamayabileceği jargon veya iç terminolojiden kaçının.

Örnekler sağlamak veya beklentileri netleştirmek için açıklama alanını kullanın. Bu hataları azaltır ve girdi kalitesini iyileştirir.

Alanları yalnızca kesinlikle gerekli olduğunda zorunlu işaretleyin. Çok fazla zorunlu alan kullanıcıları hayal kırıklığına uğratır; çok azı eksik bilgiye yol açabilir.

Alanları doğal bir akışta düzenleyin. Tanımlayıcı bilgilerle başlayın, ardından ayrıntılara geçin ve isteğe bağlı alanlarla bitirin.

Talimatlarınızda ajana her form alanını nasıl kullanacağını açıkça söyleyin. Bu, toplanan bilginin gerçekten etkili kullanılmasını sağlar.

Karşılaştırma: Form vs Prompt girdisi

BoyutForm girdisiPrompt girdisi
Kullanıcı deneyimiYapılandırılmış, yönlendirilmişAçık uçlu, esnek
Bilgi kalitesiTutarlı biçimKullanıcıya göre değişir
Kurulum çabasıDaha fazla yapılandırmaMinimal kurulum
En uygunBelirli kullanım senaryolarıGenel sohbetler
Öğrenme eğrisiKullanıcılar için daha düşükRehberlik gerekebilir

Tutarlı bir biçimde belirli bilgiye ihtiyaç duyduğunuzda Form girdisini seçin. Kullanıcıların ajanla iletişim biçiminde esneklik gerektiğinde Prompt girdisini seçin. Ayrıntılar eksikse ajan sohbet sırasında takip soruları sorabilir.

Sonraki adımlar

SSS

Bir ajanın sohbet başlamadan önce yapılandırılmış girdiye ihtiyaç duyduğu durumlarda form alanlarını kullanın. Giriş iş akışları, standartlaştırılmış istekler ve gerekli ayrıntıların serbest metin prompt'unda gizlenmemesi gereken durumlar için yararlıdırlar.

Alan adlarını, zorunlu alanları, girdi türlerini ve ajan talimatlarının form değerlerine açıkça atıfta bulunup bulunmadığını kontrol edin. Temsilî gönderimlerle test edin ve ajan bir alanı yok sayıyor veya yanlış yorumluyorsa talimatları ayarlayın.