フルフィルメントは、アクション プロジェクトでユーザー入力を取得するための会話型インターフェースと、その入力を処理して最終的にアクションを実行するためのロジックを定義します。
概要
フルフィルメントは、アシスタントからリクエストを受け取り、そのリクエストを処理して応答します。このリクエストとレスポンスのやり取りにより会話が進み、最終的に最初のユーザー リクエストが実行されるまで続きます。
次の手順では、Actions SDK と Node.js または Java / Kotlin クライアント ライブラリを使用して、フルフィルメントを作成する方法について説明します。
- ActionsSdkApp オブジェクトを初期化します。
- フルフィルメント ロジックでリクエストを処理するための関数を作成します。
ダイアログを作成する
ActionsSdkApp
オブジェクトを初期化する
次のコードは、ActionsSdkApp
をインスタンス化し、Google Cloud Functions 用のボイラープレート Node.js の設定を行います。
'use strict'; const {actionssdk} = require('actions-on-google'); const functions = require('firebase-functions'); const app = actionssdk({debug: true}); app.intent('actions.intent.MAIN', (conv) => { conv.ask('Hi!'); }); // More intent handling if needed exports.myFunction = functions.https.onRequest(app);
ResponseBuilder responseBuilder = getResponseBuilder(request).add("Hi!"); return responseBuilder.build();
{ "expectUserResponse": true, "expectedInputs": [ { "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "Hi!" } } ] } }, "possibleIntents": [ { "intent": "actions.intent.TEXT" } ] } ], "conversationToken": "{\"data\":{}}", "userStorage": "{\"data\":{}}" }
リクエストを処理する関数を作成する
ユーザーがフレーズを話すと、Google アシスタントからリクエストが届きます。リクエストに含まれるインテントを解決するには、トリガーされたインテントを処理する関数を作成します。
リクエストを処理するには:
ユーザー入力を処理するために必要なロジックを適用します。
conv.ask()
関数を呼び出して、引数として表示するレスポンスを渡します。
次のコードは、単純なレスポンスの作成方法を示しています。
conv.ask(`Hi! Say something, and I'll repeat it.`);
ResponseBuilder responseBuilder = getResponseBuilder(request).add("Hi! Say something, and I'll repeat it."); return responseBuilder.build();
{ "expectUserResponse": true, "expectedInputs": [ { "inputPrompt": { "richInitialPrompt": { "items": [ { "simpleResponse": { "textToSpeech": "Hi! Say something, and I'll repeat it." } } ] } }, "possibleIntents": [ { "intent": "actions.intent.TEXT" } ] } ], "conversationToken": "{\"data\":{}}", "userStorage": "{\"data\":{}}" }
インテントを処理する
トリガーされたインテントを処理する関数がすべて揃ったら、app.intent
を使用してハンドラをインテントに割り当てます。
app.intent('actions.intent.TEXT', (conv) => { // handle text intent. }); app.intent('actions.intent.MAIN', (conv) => { // handle main intent. });
@ForIntent("actions.intent.MAIN") public ActionResponse main(ActionRequest request) { // handle main intent // ... } @ForIntent("actions.intent.TEXT") public ActionResponse text(ActionRequest request) { // handle text intent // ... }
会話を終了する
返されるユーザー入力が不要になり、会話を終了する場合は、conv.close()
関数を呼び出します。この関数はユーザーにテキストを読み上げ、マイクを閉じて会話を終了するように Google アシスタントに指示します。
主な呼び出しインテントを処理する
ユーザーが app.intent.action.MAIN
インテントをトリガーした場合、通常はユーザー入力処理は必要ありません。アクション パッケージに多数のアクションが含まれていて、多数のユースケースを対象としている場合は、できることをいくつか伝えてユーザーを順応させることをおすすめします。
conv.ask()
関数を呼び出して、レスポンスを引数として渡します。Google アシスタントはレスポンスをユーザーに音声で伝え、ユーザーが指定したインテントのいずれかをトリガーするのを待ちます。
次のスニペットは、単純なウェルカム インテントの処理方法を示しています。
// handle the initialTrigger function handleMainIntent(conv, input) { conv.ask(input); }
private ActionResponse handleMainIntent(ResponseBuilder rb, String input) { return rb.add(input).build(); }
会話の状態
Conversation HTTP/JSON Webhook API を使用している場合は、ユーザーと Google アシスタントとの間でやり取りされる JSON 形式のオブジェクト(conversationToken
)を使用して、会話の状態を維持できます。Node.js クライアント ライブラリを使用している場合は、conv.data
フィールドから直接読み書きできます。このフィールドは、リクエストとレスポンスの間で自動的にやり取りされます。
conv.data = {something: 10}; let value = conv.data.something;
ResponseBuilder rb = getResponseBuilder(request); rb.getConversationData().put("something", 10); Object value = rb.getConversationData().get("something");