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

Bu kılavuzda, hem Actions SDK'sı hem de İşlem Oluşturucu. Aşağıdaki görevleri gerçekleştireceksiniz:

  • Node.js'yi yükleme: Node.js'mizi kullanmak için bu çalışma zamanı ortamına ihtiyacınız vardır sipariş karşılama kitaplığını kullanır.
  • Firebase CLI'ı yükleme: Bu komut satırı aracı, Etkileşimli Tuval için web uygulamaları gibi Firebase bağımlılıklarını Firebase Barındırma.
  • Gactions komut satırı aracını yükleme: Actions ile geliştirme yaparken SDK'nız varsa bu aracı kullanarak Action paketi oluşturabilir, yönetebilir ve dağıtabilirsiniz İşleminiz.
  • Actions projesi oluşturma: Actions projesi, mantıksal kapsayıcıdır Conversational Actions'ta nasıl kullanılır? İşlemi yapmadan önce Actions konsolunda bir hesap oluşturmanız gerekir oluşturmaya başlayabilir.
  • Bir örneği başlatma ve dağıtma: Bu basit örnek, Etkileşimli Tuval tarafından desteklenen İşlemler oluşturmaya başladı.

Bu hızlı başlangıcı tamamladıktan sonra, Actions projenizi yerel geliştirme ortamınıza ve Actions Builder'ın web deneyimine göz atın.

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

Node.js'ye göre Node.js'yi indirip yükleyin kullanmaları gerektiğini anlıyoruz. Node.js yüklemeniz de npm ile Firebase CLI'ı yüklemenize ve sonrasında yerel olarak konuşmayı karşılama uygulaması.

Firebase CLI'yı daha fazla bilgi edineceksiniz. Firebase CLI ile etkileşimli bir Canvas web uygulamasını Firebase Hosting'e ve gerekirse manuel olarak dağıtma Cloud Functions for Firebase'e istek karşılama.

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

gactions komut satırı arayüzü (KSA) aracını indirmek için paketi açma ve yürütme yolunuzu yapılandırma.

Gaction'ları yüklemek ve yapılandırmak için aşağıdaki 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 konuma çıkarın ve ikili dosyayı ortamın PATH değişkeni Alternatif olarak, paketi bir PATH değişkeninizde zaten bulunan konum (örneğin, /usr/local/bin).

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

    chmod +x PATH_TO/gactions

  4. CLI'nin kimliğini doğrulamak için aşağıdaki komutu çalıştırın. Bu komut başlatan kimlik doğrulama akışı için web tarayıcısı gerekir:

    gactions login

    Akış tamamlandığında CLI otomatik olarak kimliğini doğrular.

Proje oluşturma ve ayarlama

gactions komut satırı aracını kullanmadan önce Actions konsolunu kullanarak ve önemli kişilere projeye erişim izni vererek. Oluşturmak ve ayarlamak aşağıdakileri 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. Aşağıdaki adımları uygulayarak Google Cloud Console'da Actions API'yi etkinleştirin Etkinleştirme ve devre dışı bırakma API'ler. Bu, grupların projenizle etkileşim kurmasına olanak tanır.

Hello World örneğini indirme

hello World etkileşimli örneği, basit bir Eylemin nasıl oluşturulacağını gösterir tek bir Action'a sahip olması gerekir.

  1. Boş bir dizin oluşturun ve Etkileşimli Tuval örneğini şurada başlatın: o dizine eklenir. Örneğin, aşağıdaki kod örneği şurada başlatır: Örnek olarak kullanılan interactive-canvas-sample/ dizini genel hatlarıyla inceleyeceğiz:

    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 ayarladıktan sonra, Etkileşimli Tuval web uygulamasını dağıtabilir ve eyleme dökülebilir. Bu işlem, İşlemlerinizin taslak sürümünü oluşturur Eylem simülatörüne dağıtarak önizleme ve test etme işlemlerini yapabilirsiniz:

  1. interactive-canvas-sample/ dizininden aşağıdaki komutu çalıştırın (public/ dizin).

    firebase deploy --project PROJECT_ID --only hosting

    Web uygulamasının oluşturulmuş bir sürümünü, Tarayıcıdaki Firebase CLI: 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 ile değiştirin.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';

  3. interactive-canvas-sample/sdk/ dizininden aşağıdaki komutu çalıştırın komutuna dahil etmek için, İşlemler projenizin yerel sürümünü bir taslak sürüm:

    gactions push

  4. interactive-canvas-sample/sdk/ dizininden aşağıdaki komutu çalıştırın komutuna ekleyerek simülatörde Actions projenizi test edebilirsiniz:

    gactions deploy preview

  5. Komut satırı aracının simülatöre gitmek için döndürdüğü bağlantıyı açın.

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

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