Agen bawaan yang Anda buat pada langkah terakhir tidak dapat memberikan data dinamis seperti saldo akun, karena semuanya di-hardcode ke agen. Pada langkah tutorial ini, Anda akan membuat webhook yang dapat memberikan data dinamis kepada agen. Cloud Functions digunakan untuk menghosting webhook dalam tutorial ini karena kemudahannya. Namun, ada banyak cara lain yang dapat Anda gunakan untuk menghosting layanan webhook. Contoh ini juga menggunakan bahasa pemrograman Go, tetapi Anda dapat menggunakan bahasa apa pun yang didukung oleh Cloud Functions.
Membuat Fungsi
Cloud Functions dapat dibuat dengan Konsol Google Cloud (buka dokumentasi, buka konsol). Untuk membuat fungsi di tutorial ini:
Agen Dialogflow Anda dan fungsinya harus berada dalam project yang sama. Ini adalah cara termudah bagi Dialogflow untuk memiliki akses yang aman ke fungsi Anda. Sebelum membuat fungsi, pilih project Anda dari Konsol Google Cloud.
Buka halaman ringkasan Cloud Functions.
Klik Create Function, dan tetapkan kolom berikut:
- Lingkungan: generasi ke-1
- Nama fungsi: tutorial-banking-webhook
- Region: Jika Anda menentukan wilayah untuk agen, gunakan wilayah yang sama.
- Jenis Pemicu HTTP: HTTP
- URL: Klik tombol salin di sini dan simpan nilainya. Anda akan memerlukan URL ini saat mengonfigurasi webhook.
- Autentikasi: Memerlukan autentikasi
- Wajibkan HTTPS: dicentang
Klik Simpan.
Klik Next (Anda tidak memerlukan setelan runtime, build, koneksi, atau keamanan khusus).
Tetapkan kolom berikut:
- Runtime: Pilih runtime Go terbaru.
- Kode sumber: Editor Inline
- Titik entri: HandleWebhookRequest
Ganti kode dengan kode berikut:
package estwh import ( "context" "encoding/json" "fmt" "log" "net/http" "os" "strings" "cloud.google.com/go/spanner" "google.golang.org/grpc/codes" ) // client is a Spanner client, created only once to avoid creation // for every request. // See: https://cloud.google.com/functions/docs/concepts/go-runtime#one-time_initialization var client *spanner.Client func init() { // If using a database, these environment variables will be set. pid := os.Getenv("PROJECT_ID") iid := os.Getenv("SPANNER_INSTANCE_ID") did := os.Getenv("SPANNER_DATABASE_ID") if pid != "" && iid != "" && did != "" { db := fmt.Sprintf("projects/%s/instances/%s/databases/%s", pid, iid, did) log.Printf("Creating Spanner client for %s", db) var err error // Use the background context when creating the client, // but use the request context for calls to the client. // See: https://cloud.google.com/functions/docs/concepts/go-runtime#contextcontext client, err = spanner.NewClient(context.Background(), db) if err != nil { log.Fatalf("spanner.NewClient: %v", err) } } } type queryResult struct { Action string `json:"action"` Parameters map[string]interface{} `json:"parameters"` } type text struct { Text []string `json:"text"` } type message struct { Text text `json:"text"` } // webhookRequest is used to unmarshal a WebhookRequest JSON object. Note that // not all members need to be defined--just those that you need to process. // As an alternative, you could use the types provided by // the Dialogflow protocol buffers: // https://godoc.org/google.golang.org/genproto/googleapis/cloud/dialogflow/v2#WebhookRequest type webhookRequest struct { Session string `json:"session"` ResponseID string `json:"responseId"` QueryResult queryResult `json:"queryResult"` } // webhookResponse is used to marshal a WebhookResponse JSON object. Note that // not all members need to be defined--just those that you need to process. // As an alternative, you could use the types provided by // the Dialogflow protocol buffers: // https://godoc.org/google.golang.org/genproto/googleapis/cloud/dialogflow/v2#WebhookResponse type webhookResponse struct { FulfillmentMessages []message `json:"fulfillmentMessages"` } // accountBalanceCheck handles the similar named action func accountBalanceCheck(ctx context.Context, request webhookRequest) ( webhookResponse, error) { account := request.QueryResult.Parameters["account"].(string) account = strings.ToLower(account) var table string if account == "savings account" { table = "Savings" } else { table = "Checking" } s := "Your balance is $0" if client != nil { // A Spanner client exists, so access the database. // See: https://pkg.go.dev/cloud.google.com/go/spanner#ReadOnlyTransaction.ReadRow row, err := client.Single().ReadRow(ctx, table, spanner.Key{1}, // The account ID []string{"Balance"}) if err != nil { if spanner.ErrCode(err) == codes.NotFound { log.Printf("Account %d not found", 1) } else { return webhookResponse{}, err } } else { // A row was returned, so check the value var balance int64 err := row.Column(0, &balance) if err != nil { return webhookResponse{}, err } s = fmt.Sprintf("Your balance is $%.2f", float64(balance)/100.0) } } response := webhookResponse{ FulfillmentMessages: []message{ { Text: text{ Text: []string{s}, }, }, }, } return response, nil } // Define a type for handler functions. type handlerFn func(ctx context.Context, request webhookRequest) ( webhookResponse, error) // Create a map from action to handler function. var handlers map[string]handlerFn = map[string]handlerFn{ "account.balance.check": accountBalanceCheck, } // handleError handles internal errors. func handleError(w http.ResponseWriter, err error) { log.Printf("ERROR: %v", err) http.Error(w, fmt.Sprintf("ERROR: %v", err), http.StatusInternalServerError) } // HandleWebhookRequest handles WebhookRequest and sends the WebhookResponse. func HandleWebhookRequest(w http.ResponseWriter, r *http.Request) { var request webhookRequest var response webhookResponse var err error // Read input JSON if err = json.NewDecoder(r.Body).Decode(&request); err != nil { handleError(w, err) return } log.Printf("Request: %+v", request) // Get the action from the request, and call the corresponding // function that handles that action. action := request.QueryResult.Action if fn, ok := handlers[action]; ok { response, err = fn(r.Context(), request) } else { err = fmt.Errorf("Unknown action: %s", action) } if err != nil { handleError(w, err) return } log.Printf("Response: %+v", response) // Send response if err = json.NewEncoder(w).Encode(&response); err != nil { handleError(w, err) return } }
Klik Deploy.
Tunggu hingga indikator status menunjukkan bahwa fungsi telah berhasil di-deploy. Sambil menunggu, periksa kode yang baru saja Anda deploy.
Mengonfigurasi webhook untuk agen Anda
Setelah webhook ada sebagai layanan, Anda harus mengaitkan webhook ini dengan agen Anda. Hal ini dilakukan melalui fulfillment. Untuk mengaktifkan dan mengelola fulfillment agen Anda:
- Buka Dialogflow ES Console.
- Pilih agen siap pakai yang baru saja Anda buat.
- Pilih Fulfillment di menu sidebar kiri.
- Alihkan kolom Webhook ke Enabled.
- Masukkan URL yang Anda salin di atas. Biarkan kolom lain kosong.
- Klik Simpan di bagian bawah halaman.
Setelah fulfillment diaktifkan untuk agen, Anda harus mengaktifkan fulfillment untuk intent:
- Pilih Intent di menu sidebar kiri.
- Pilih intent account.balance.check.
- Scroll ke bawah ke bagian Fulfillment.
- Alihkan tombol Aktifkan panggilan webhook untuk intent ini ke aktif.
- Klik Simpan.
Coba agen
Agen Anda kini siap untuk mencoba. Klik tombol Test Agent untuk membuka simulator. Coba lakukan percakapan berikut dengan agen:
Percakapan dalam percakapan | Anda | Agen |
---|---|---|
1 | Halo | Halo, terima kasih telah memilih ACME Bank. |
2 | Saya ingin tahu saldo rekening saya | Rekening apa yang Anda inginkan saldonya untuk: tabungan atau giro? |
3 | Memeriksa | Berikut saldo terbaru Anda: Rp0,00 |
Pada percakapan #3, Anda memasukkan "memeriksa" sebagai jenis akun. Intent account.balance.check memiliki parameter yang disebut account. Parameter ini ditetapkan ke "memeriksa" dalam percakapan ini. Intent tersebut juga memiliki nilai tindakan "account.balance.check". Layanan webhook dipanggil, lalu parameter dan nilai tindakan diteruskan.
Jika memeriksa kode webhook di atas, Anda akan melihat bahwa tindakan ini memicu fungsi bernama yang serupa untuk dipanggil. Fungsi tersebut menentukan saldo akun. Fungsi ini memeriksa apakah variabel lingkungan tertentu ditetapkan dengan informasi untuk terhubung ke database. Jika variabel lingkungan ini tidak ditetapkan, fungsi akan menggunakan saldo akun hardcode. Pada langkah berikutnya, Anda akan mengubah lingkungan untuk fungsi tersebut agar dapat mengambil data dari database.
Pemecahan masalah
Kode webhook menyertakan laporan logging. Jika Anda mengalami masalah, coba lihat log untuk fungsi Anda.
Informasi selengkapnya
Untuk informasi selengkapnya tentang langkah-langkah di atas, lihat: