Actions SDK'sı ve Oluşturucu hızlı başlangıç kılavuzu

Bu rehberde, hem Actions SDK'sını hem de Actions Builder'ı kullanarak Actions derlemek için ortamınızı nasıl ayarlayabileceğiniz açıklanmaktadır. Aşağıdaki görevleri gerçekleştireceksiniz:

  • Node.js'yi yükleme: Node.js karşılama kitaplığımızı kullanmak için bu çalışma zamanı ortamına ihtiyacınız vardır.
  • Firebase CLI'yı yükleme: Bu komut satırı aracı, Etkileşimli Tuval için web uygulamaları gibi Firebase bağımlılıklarını geliştirip Firebase Hosting'e dağıtmanızı sağlar.
  • Gactions komut satırı aracını yükleme: Actions SDK'sı ile geliştirme yaparken İşleminiz için Action paketi oluşturmak, yönetmek ve dağıtmak için bu aracı kullanırsınız.
  • Actions projesi oluşturma: Actions projesi, Conversational Actions'ınız için mantıksal kapsayıcıdır. Derlemeye başlamadan önce Actions Console'da bir hesap oluşturmanız gerekir.
  • Örneği başlatma ve dağıtma: Bu basit örnekte, Etkileşimli Tuval tarafından desteklenen İşlemleri nasıl oluşturmaya başlayacağınız gösterilmektedir.

Bu hızlı başlangıcı tamamladıktan sonra Actions projenizi yerel geliştirme ortamınız ile Actions Builder'ın web deneyimi arasında senkronize edebilirsiniz.

Node.js ve Firebase CLI'yi yükleme

Sipariş karşılama kitaplığımızı kullanmak için Node.js belgelerine göre Node.js'yi indirip yükleyin. Node.js yüklemeniz, görüşme istek karşılama uygulamanızı yerel olarak çalıştırmak için npm ve daha sonra Firebase CLI'yi yüklemenize de olanak tanır.

Firebase CLI'yı Firebase belgelerine göre yükleyin ve ayarlayın. Firebase CLI, Firebase Hosting'e Etkileşimli Canvas web uygulaması dağıtmanıza ve gerekirse Cloud Functions for Firebase'e istek karşılamayı manuel olarak dağıtmanıza olanak tanır.

gactions komut satırı aracını yükleyin

Bir yükleme paketi indirerek, paketi açarak ve yürütme yolunuzu yapılandırarak gactions komut satırı arayüzü (CLI) aracını yükleyin.

Gactions'ları yüklemek ve yapılandırmak için şu adımları uygulayın:

  1. İşletim sisteminize uygun paketi indirin:

    Platform Paket Denetim Toplamı
    Windows İndir SHA256
    Linux İndir SHA256
    Mac OS İndir SHA256
  2. Paketi istediğiniz bir konuma çıkarın ve ikili dosyayı ortamınızın PATH değişkenine ekleyin. Alternatif olarak, paketi zaten PATH değişkeninizde bulunan bir konuma (ör. /usr/local/bin) çıkarın.

  3. Linux ve Mac'te, gerekirse yürütme izinlerini etkinleştirin:

    chmod +x PATH_TO/gactions
  4. KSA'nın kimliğini doğrulamak için aşağıdaki komutu çalıştırın. Bu komut, kimlik doğrulama akışı başlatır ve web tarayıcısı gerektirir:

    gactions login

    Akış tamamlandığında KSA, kimliği otomatik olarak doğrular.

Proje oluşturma ve ayarlama

gactions komut satırı aracını kullanmadan önce Actions Console'da bir proje oluşturmanız ve gaction'ların projeye erişmesine izin vermeniz gerekir. Proje oluşturmak ve ayarlamak için şunları yapın:

  1. Actions Console'a gidin.
  2. Yeni proje'yi tıklayın, bir proje adı girin ve Proje oluştur'u tıklayın.
  3. Bir kategori seçip İleri'yi tıklayın.
  4. Boş proje'yi seçin ve Derlemeye başla'yı tıklayın.
  5. API'leri etkinleştirme ve devre dışı bırakma bölümündeki talimatları uygulayarak Google Cloud konsolunda Actions API'yi etkinleştirin. Böylece gruplar, projenizle etkileşime geçer.

Merhaba dünya örneğini alın

"hello world" etkileşimli örneği, Etkileşimli Tuval tarafından desteklenen tek bir Action ile basit bir Actions projesinin nasıl oluşturulacağını gösterir.

  1. Boş bir dizin oluşturun ve bu dizinde Etkileşimli Tuval örneğini başlatın. Örneğin, aşağıdaki kod, bu belgede örnek olarak kullanılan bir interactive-canvas-sample/ dizininde örneği başlatır:

    gactions init interactive-canvas --dest interactive-canvas-sample
    cd interactive-canvas-sample
    
  2. interactive-canvas-sample/sdk/settings/settings.yaml dosyasını açın ve projectId alanındaki değeri projenizin kimliğiyle değiştirin.

Örneği dağıtma ve test etme

Örneği oluşturduktan sonra Etkileşimli Tuval web uygulamasını ve Actions projenizi dağıtabilirsiniz. Bu işlem, Actions projenizin taslak sürümünü oluşturur. Bu sürümü önizlemek ve test etmek için Actions simülatörüne dağıtabilirsiniz:

  1. Etkileşimli Tuval web uygulamasını (public/ dizininin içeriği) dağıtmak için interactive-canvas-sample/ dizininden aşağıdaki komutu çalıştırın.

    firebase deploy --project PROJECT_ID --only hosting
    

    Web uygulamasının oluşturulmuş bir sürümünü, Firebase CLI tarafından tarayıcıda döndürülen URL'de görebilirsiniz: https://PROJECT_ID.web.app.

  2. interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js dosyasını açın ve CANVAS_URL değişkeninin değerini projenizin web uygulaması URL'siyle değiştirin.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';
    
  3. Actions projenizin yerel sürümünü taslak sürüm olarak konsola aktarmak için interactive-canvas-sample/sdk/ dizininden aşağıdaki komutu çalıştırın:

    gactions push
    
  4. Actions projenizi simülatörde test etmek için interactive-canvas-sample/sdk/ dizininden aşağıdaki komutu çalıştırın:

    gactions deploy preview
    
  5. Simülatöre gitmek için komut satırı aracının döndürdüğü bağlantıyı açın.

  6. İşlemi başlatmak için simülasyon aracında "Talk to Interactive kanvas örneği" ifadesini girin. https://PROJECT_ID.web.app konumunda dağıtılan web uygulaması tarafından desteklenen dönen bir üçgen görürsünüz.

    Şekil 1. Actions projesini önizleyen simülasyon aracı