Actions SDK ve Builder hızlı başlangıç kılavuzu

Bu rehber, Actions SDK'sını ve Actions Builder'ı kullanarak İşlemler oluşturmak için ortamınızı ayarlamanıza yardımcı olur. Aşağıdaki görevleri gerçekleştirirsiniz:

  • 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ı, Firebase Etkileşimlilerini (ör. Etkileşimli Tuval için web uygulamaları) geliştirip Firebase Hosting'e dağıtmanızı sağlar.
  • Gactions komut satırı aracını yükleyin: Actions SDK ile geliştirme yaparken Action'ınız için Action paketi oluşturmak, yönetmek ve dağıtmak üzere bu aracı kullanabilirsiniz.
  • Bir Eylem projesi oluşturun: İşlemler projesi, Sohbet İşlemleriniz için mantıksal kapsayıcıdır. Oluşturmaya başlamadan önce Actions konsolunda bir tane oluşturmanız gerekir.
  • Örneği başlatma ve dağıtma: Bu basit örnek, Etkileşimli Tuval tarafından desteklenen İşlemler oluşturmaya nasıl başlayacağınızı gösterir.

Bu hızlı başlangıç adımını tamamladıktan sonra Actions projenizi yerel geliştirme ortamınızla Action Builder'ın web deneyimi arasında senkronize edebilirsiniz.

Node.js'yi ve Firebase CLI'yı yükleme

Sipariş karşılama kitaplığımızı kullanmak için Node.js dokümanlarına göre Node.js dosyasını indirip yükleyin. Node.js yüklemeniz, Firebase CLI'yı npm ile ve daha sonra yerel olarak çalıştırmanızı sağlar.

Firebase CLI'yı Firebase belgelerine göre yükleyip kurun. Firebase CLI, Firebase Hosting'e Etkileşimli Tuval uygulaması dağıtmanızı ve gerekirse isteği Cloud Functions for Firebase'e manuel olarak dağıtmanızı sağlar.

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

Bir yükleme paketi indirip paketi açtıktan sonra yürütme yolunu yapılandırarak gactions komut satırı arayüzünü (CLI) yükleyin.

Yapılandırmaları yüklemek ve yapılandırmak için aşağıdaki adımları uygulayın:

  1. İşletim sisteminiz için uygun paketi indirin:

    Platform Paket Denetim Toplamı
    Windows İndir SHA256
    Linux İndir SHA256
    Mac OS İndir SHA256
  2. Paketi dilediğiniz bir konuma çıkarın ve ikili programı ortamınızın PATH değişkenine ekleyin. Alternatif olarak, paketi zaten PATH değişkeninizde yer alan 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'da kimlik doğrulaması yapmak için aşağıdaki komutu çalıştırın. Bu komut bir kimlik doğrulama akışı başlatır ve web tarayıcısı gerektirir:

    gactions login

    Akış tamamlandığında KSA otomatik olarak kimlik doğrulaması yapar.

Proje oluşturma ve ayarlama

Gactions komut satırı aracını kullanabilmek için Actions konsolunda bir proje oluşturmanız ve gregs'ın projeye erişmesine izin vermeniz gerekir. Proje oluşturmak ve ayarlamak için aşağıdakileri yapın:

  1. İşlemler konsoluna gidin.
  2. Yeni proje'yi tıklayın, bir proje adı girin ve Proje oluştur'u tıklayın.
  3. Bir kategori seçin ve İ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 Console'da Actions API'yi etkinleştirin. Bu, izinlerin projenizle etkileşim kurmasına olanak tanır.

Merhaba dünya örneğine göz atın

Hello World etkileşimli örneği, Etkileşimli Tuval tarafından desteklenen tek bir Action ile basit bir Actions projesi oluşturmayı gösterir.

  1. Boş bir dizin oluşturun ve bu dizindeki Etkileşimli Tuval örneğini başlatın. Örneğin, aşağıdaki kod, bu belgede örnek olarak kullanılan 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ının değerini, 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 İşlemler projenizi dağıtabilirsiniz. Bu işlem, Actions projenizin taslak sürümünü oluşturur. Bu sürümü önizleme ve test 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/ dizininde aşağıdaki komutu çalıştırın.

    firebase deploy --project PROJECT_ID --only hosting
    

    Firebase CLI tarafından döndürülen URL'de bir web uygulaması kullanılarak oluşturulmuş bir sürümü 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'si olarak değiştirin.

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

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

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

  6. İşlemi başlatmak için simülatörde "Etkileşimli tuval örneğiyle konuş" ifadesini girin. https://PROJECT_ID.web.app adresinde dağıtılan web uygulaması tarafından desteklenen bir dönen üçgen göreceksiniz

    Şekil 1. Actions projesinin önizlemesini yapan simülasyon aracı