Alice için Beceri: Fikirden Yayına Hızlı Yol

Alice için bir beceri oluşturmak adına, onu Yandex Dialogs konsolunda kaydetmek, bir backend bağlamak (Webhook veya Cloud Functions), işleyicinin doğru bir JSON yanıtı döndürmesini sağlamak ve test/moderasyon süreçlerinden geçirmek yeterlidir. Aşağıda, bir akşamüstü tekrarlayabileceğiniz minimum plan yer almaktadır.

Hazırlık: Beceri türü ve senaryo

Öncelikle türü belirleyin:

• Normal beceri — oyunlar, bilgi verme, hizmet randevusu alma, quizler, derlemeler. En kolay başlangıç.
• Akıllı ev — cihaz yönetimi; çoğunlukla hesap bağlama (OAuth) ve daha fazla gereksinim gerekir.

Ardından 10 dakika içinde diyalogun "iskeletini" taslak olarak hazırlayın:

1. karşılama (1 cümle: ne yapabildiğinizi belirtin),
2. 3–5 adet "insanın söyleyeceği şekilde" komut,
3. "yardım",
4. anlaşılmayan girdilerin işlenmesi,
5. çıkış ("dur/çık").

Yandex Dialogs'ta beceri oluşturma

Geliştirici konsolundaki işlemler:

1. Diyalog oluştur → Beceri.
2. Ad, etkinleştirme adları, açıklama ve kategoriyi doldurun.
3. Backend bağlantı yöntemini seçin: Webhook URL veya Cloud Functions.
4. Örnek istekler ekleyin (kullanıcının beceriyi nasıl başlatacağı/kullanacağı).

Backend: Webhook veya Cloud Functions ve minimum yanıt

Webhook, zaten bir sunucunuz varsa ve tam kontrol istiyorsanız uygundur.
Cloud Functions, prototip için daha kullanışlıdır: Daha az yapılandırma, daha hızlı başlangıç.

Temel kural: İşleyiciniz hızlı ve doğru JSON formatında yanıt vermelidir.

Minimum "iskelet" yanıt

{
  "response": {
    "text": "Merhaba! Komutları öğrenmek için «yardım» de.",
    "tts": "Merhaba! Komutları öğrenmek için «yardım» de.",
    "end_session": false
  },
  "version": "1.0"
}

Hemen dahil edilmesi gereken mini mantık

• İlk girişte (session.new) — kısa bir karşılama + 1–2 ipucu.
• "Yardım" komutu — komut listesi.
• Cümle tanınmazsa — "Anlamadım. Şunu deyin…" ve seçenekler sunun.
• "Dur/çık" — end_session: true.

Test ve yayınlama

1. Konsolda test: Cümleleri deneyin, ham JSON'a bakın, "yardım/anlamadım/çık" dallarını kontrol edin.
2. Cihazda kontrol: Gizli erişimi açın ve beceriyi aynı hesaptan başlatın (böylece seslendirme, duraksamalar ve ifade sorunlarını yakalarsınız).
3. Moderasyondan önce:
   • Açıklama gerçek davranışla eşleşiyor,
   • Anlaşılır bir "yardım" komutu var,
   • Beceri tutarlı yanıt veriyor (çökme yok),
   • Metinlerde "her şeyi vaat eden" ifadeler ve gizli işlevler yok.

Backend seçeneklerinin karşılaştırılması (özetle)

Sık yapılan hatalar

• Uzun yanıt süresi: Harici API'ler yavaşlıyor, önbellek yok.
  Çözüm: Önbellekleme yapın, istek zincirlerini kısaltın, yalnızca limitlere uyuyorsanız "aldım, netleştiriyorum…" gibi yanıt verin.
• İpucu yok: Kullanıcı ne söyleyeceğini anlamıyor.
  Çözüm: Karşılama + "Şunu deyin: … veya …".
• Çok "geniş" konu: Beceri her şeyi yapmaya çalışıyor ve karışıyor.
  Çözüm: Tek anlaşılır senaryo, ardından genişletme.
• Bozuk JSON: version unutulmuş, yanlış response yapısı, boş alanlar.
  Çözüm: Minimum şablonla başlayın ve öğeleri tek tek değiştirin.

SSS

Programlama olmadan beceri oluşturulabilir mi?
Tamamen — nadiren: Genellikle bir backend (Webhook/fonksiyon) gerekir. Ancak Cloud Functions'ta basit bir şablonla ve minimum "yardım/yankı" mantığıyla başlanabilir.

Neden beceri ada göre bulunmuyor?
Çoğunlukla sorun etkinleştirme adındadır (çok genel/kötü tanınıyor) veya beceri yayınlanmamış/özel ve siz başka bir hesaptan test ediyorsunuz.

Hemen NLP/nietler yapmak gerekir mi?
Başlangıçta senaryo ve ipuçları daha önemlidir. Diyalog kısa ve kontrollü ise, birçok beceride basit kurallar ve anahtar cümleler yeterlidir.