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:
İşletim sisteminize uygun paketi indirin:
Platform Paket Denetim Toplamı Windows İndir SHA256 Linux İndir SHA256 Mac OS İndir SHA256 Paketi istediğiniz konuma çıkarın ve ikili dosyayı ortamın
PATH
değişkeni Alternatif olarak, paketi birPATH
değişkeninizde zaten bulunan konum (örneğin,/usr/local/bin
).Linux ve Mac'te, gerekiyorsa yürütme izinlerini etkinleştirin:
chmod +x PATH_TO/gactions
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:
- Actions Console'a gidin.
- Yeni proje'yi tıklayın, bir proje adı girin ve Proje oluştur'u tıklayın.
- Bir kategori seçip İleri'yi tıklayın.
- Boş proje'yi seçin ve Derlemeye başla'yı tıklayın.
- 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.
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
interactive-canvas-sample/sdk/settings/settings.yaml
dosyasını açın veprojectId
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:
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
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
dosyasını açın veCANVAS_URL
değişkeninin değerini projenizin web uygulaması URL'si ile değiştirin.const CANVAS_URL = 'https://PROJECT_ID.web.app';
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
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
Komut satırı aracının simülatöre gitmek için döndürdüğü bağlantıyı açın.
İş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:
'nı inceleyin.https://PROJECT_ID.web.app
.