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:
İşletim sisteminiz için uygun paketi indirin:
Platform Paket Denetim Toplamı Windows İndir SHA256 Linux İndir SHA256 Mac OS İndir SHA256 Paketi dilediğiniz bir konuma çıkarın ve ikili programı ortamınızın
PATH
değişkenine ekleyin. Alternatif olarak, paketi zatenPATH
değişkeninizde yer alan bir konuma (ör./usr/local/bin
) çıkarın.Linux ve Mac'te, gerekirse yürütme izinlerini etkinleştirin:
chmod +x PATH_TO/gactions
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:
- İşlemler konsoluna gidin.
- Yeni proje'yi tıklayın, bir proje adı girin ve Proje oluştur'u tıklayın.
- Bir kategori seçin ve İleri'yi tıklayın.
- Boş proje'yi seçin ve Derlemeye başla'yı tıklayın.
- 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.
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
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 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:
Etkileşimli Tuval web uygulamasını (
public/
dizininin içeriği) dağıtmak içininteractive-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
.interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
dosyasını açın veCANVAS_URL
değişkeninin değerini, projenizin web uygulaması URL'si olarak değiştirin.const CANVAS_URL = 'https://PROJECT_ID.web.app';
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
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
Simülasyon aracına gitmek için komut satırı aracının döndürdüğü bağlantıyı açın.
İş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ı