会話型アクションのサポートは 2023 年 6 月 13 日に終了しました。詳細については、会話型アクションの廃止をご覧ください。

このページは Cloud Translation API によって翻訳されました。

プロジェクトをビルドする

</ph> <ph type="x-smartling-placeholder"></ph>

Actions プロジェクトは、すべてのアクションを 1 つのコンテナにパッケージ化します。マイページこのプロジェクトを Actions on Google に公開して、Google アシスタントが会話エクスペリエンスを呼び出せます

アクションプロジェクトコンポーネント — **図 1**. Actions プロジェクトの構造

Actions プロジェクトを作成するには、次の下位コンポーネントを使用します。

設定とリソースでプロジェクトメタデータを定義するプロジェクトアイコンなどのリソースですGoogle はこの情報を使用してユーザーがアクションを見つけて呼び出すことができるように、できます。
インテントは、実行されるタスクを表します。イベントを検出できます。最も一般的なのはユーザーインテントです。これらのインテントを使用すると、 NLU（自然言語理解）によって自然に拡張されるフレーズ多数の類似フレーズを含めるようにしますNLU は、トレーニングデータのこれらのフレーズによって、Google アシスタントがユーザーのマッチングに使用する言語モデルをトレーニングします。表示されます。会話中、一部のユーザー入力がインテントの言語と一致する場合アシスタントランタイムがアクションにインテントを送信し、ユーザーに返信します
型を使用すると、ユーザー入力から構造化データを抽出できます。方法トレーニングフレーズにタイプアノテーションを付けることで、NLU は関連する構造化されたフレーズを抽出できます。入力が自動で行われるため、自由形式の入力を解析する必要はありません。
シーンはインテントを処理します。シーンは主なロジックエグゼキュータです。確認しましょう。スロット充填、条件付きロジックの評価、さらには外部のウェブサービスを呼び出して、必要があります。インテントとシーンを組み合わせることで、特定のユーザー入力やシステムイベントを検出して、対応するできます。
プロンプトでは、以下に使用する静的または動的な回答を定義します。ユーザーに返信します。
Webhook を使用すると、追加の作業をウェブサービスに委任できます。データの検証やプロンプトの生成などのタスクを自動化します。あなたのアクション JSON ベースの Webhook プロトコルを介してフルフィルメントと通信します。
Interactive Canvas を使用すると、 HTML、CSS、JavaScript を活用したウェブアプリで、臨場感あふれるエクスペリエンスを実現できます。

プロジェクトを作成する

開発する前に、Actions Console でプロジェクトを作成する必要があります。 Google アシスタント。プロジェクトを作成するには:

Actions Console に移動します。
[New project]（新しいプロジェクト）をクリックします。
プロジェクトの名前を入力して、[Create Project]（プロジェクトを作成）をクリックします。
[What kind of Action do you want to build?] 画面で、プロジェクトに最もよく当てはまるカテゴリを選択して [次へ] をクリックします。
[How do you want to build it] 画面でビルド方法を選択します。 [Start Building] をクリックします。たとえば、空の文字列をサンプルとしても使用できます。

で確認できます。 <ph type="x-smartling-placeholder">

</ph> キーポイント: Interactive Canvas 向けに作成する場合は、追加手順: <ph type="x-smartling-placeholder">

[ゲーム] カードを選択しなかった場合は、どのようなタイプのアクションビルドしますか？] 画面で、上部のナビゲーションの [デプロイ] をクリックします。 [詳細情報] で [ゲーム&カテゴリ [保存] をクリックします。
Actions Console の上部ナビゲーションで [Develop] をクリックします。
左側のナビゲーションで [Interactive Canvas] をクリックします。
[Does your Action use Interactive Canvas?]（アクションで Interactive Canvas を使用しますか？）で、[Yes]（はい）を選択します。
省略可: [デフォルトのウェブアプリの URL を設定する] 欄にウェブアプリの URL を入力します。表示されます。このアクションにより、URL フィールドを含むデフォルトの Canvas レスポンスが Main の呼び出しに追加されます。
[保存] をクリックします。

ローカル Actions SDK プロジェクトを作成する

Actions Console で Actions プロジェクトを作成したら、ローカル開発環境でプロジェクトを初期化します。

既存の Actions プロジェクトから Actions SDK プロジェクトを初期化する手順は次のとおりです。手順は次のとおりです。

Actions プロジェクト用の空のディレクトリをローカルファイルシステムに作成します。
この空のディレクトリに sdk ディレクトリを作成します。
ターミナルで作業ディレクトリを sdk ディレクトリに変更します。

空のプロジェクトで開始する

コンソールで作成した空のプロジェクトから開始する場合は、 gactions pull --project-id <my-project-id> を実行します。

$ mkdir myAction
$ cd myAction
$ mkdir sdk
$ cd sdk
$ gactions pull --project-id my-project-id
Pulling your project files from Draft for a project id: "my-project-id"
✔ Done. You should see the files written in path/to/myAction/sdk

サンプルプロジェクトで開始する

サンプルプロジェクトから開始する場合は、gactions init <sample name> を実行します。

$ mkdir actions-test
$ cd actions-test
$ mkdir sdk
$ cd sdk
$ gactions init question
Writing sample files for question.
✔ Done. Please checkout the following documentation - https://developers.google.com/assistant/conversational/build on the next steps on how to get started.

プロジェクト情報を定義する

プロジェクトの設定とリソースでは、プロジェクトに関する情報を定義します。たとえば、 Feature and Surface のサポート、サポートされている言語 / 地域、表示名、説明、作成できます次の表に、主な設定とリソースを示します。提供します。Actions on Google はこれを使用します。情報を使用して、プロジェクトをアシスタントにデプロイ、公開できます。ディレクトリをご覧ください。

名前	説明
ディレクトリ情報	Actions on Google が公開できるよう情報を提供します Assistant ディレクトリに移動できます。メタデータと除外を含むプロジェクトに関する情報と、ロゴとバナー画像用の画像リソース。
地域ターゲティング	アクションを使用できる言語 / 地域を設定します。
サーフェス機能	アクションを使用できるサーフェスを設定します。
会社情報	会社の連絡先情報を指定します。
ブランドの確認	所有するウェブサイトまたは Android アプリを接続して、さまざまな特典を利用しましょう予約済みの呼び出し名やウェブサイトのリンクなど、特別な設定は必要ありません。
リリース	アクション用にさまざまなテスト版リリースと製品版リリースを設定しますおすすめします
アシスタントのリンク	ユーザーがウェブプロパティからアクションを呼び出せるようにします。

プロジェクト情報を定義するには:

sdk/settings/settings.yaml でアクションプロジェクトのグローバル設定を定義します。設定リファレンスをご覧ください。サポートされている値については、ドキュメントをご覧ください。

次のスニペットは、sdk/settings/settings.yaml ファイルの例を示しています。
```
accountLinking:
  enableAccountCreation: true
  linkingType: GOOGLE_SIGN_IN
category: GAMES_AND_TRIVIA
projectId: my-project-id
...
```
<ph type="x-smartling-placeholder">
</ph> キーポイント: Interactive Canvas 向けに作成する場合は、追加手順: <ph type="x-smartling-placeholder">
1. settings.yaml で category フィールドを設定するファイルを GAMES_AND_TRIVIA に追加して、ユーザーがアクションを見つけます。
2. usesInteractiveCanvas フィールドを settings.yaml ファイルを true にコピーします。
ユーザーの言語 / 地域に応じて変更できる設定を定義します（例: 呼び出しフレーズなど）を sdk/settings/<locale>/settings.yaml ファイルに記述し、 locale を対象の言語 / 地域に置き換えます。

LocalizedSettings をご覧ください。サポートされている値については、リファレンスドキュメントをご覧ください。

次のスニペットは、 sdk/settings/en/settings.yaml ファイル:
```
localizedSettings:
  developerEmail: developer@developers.com
  developerName: Developer Name
  displayName: My Display Name
  fullDescription: full description of the action
  largeBannerImage: https://path/to/large/banner
  privacyPolicyUrl: http://path/to/privacy/policy
  sampleInvocations:
  - Talk to My Display Name
  shortDescription: short description of the action
  smallLogoImage: https://path/to/small/logo
  voice: female_1
...
```

リソースを追加

画像ファイル、音声ファイル、文字列などのリソースを Actions プロジェクトを作成し、構成ファイル（例: 定義や条件など）を指定します。$resources

プロジェクトリソースは resources/ に保存され、各リソースタイプはディレクトリ内のフォルダを割り当てました。

リソース内にロケール固有のフォルダを作成することで、リソースをローカライズできます。たとえば、スペイン語バージョンの文字列を resources/strings/es/<filename>.yaml。

画像

画像ファイルは resources/images/ に保存され、参照できます $resources.images.<name of the image file without file extension> に置き換えます。使用できるファイル拡張子は次のとおりです。

gif
png
jpg
jpeg

たとえば、小さいロゴの英語版を resources/images/en/square.png、英語版の大型バナーはそれぞれ resources/images/en/landscape.jpg に保存しました。前の例の sdk/settings/en/settings.yaml は次のようになります。

localizedSettings:
  developerEmail: developer@developers.com
  developerName: Developer Name
  displayName: My Display Name
  fullDescription: full description of the action

  largeBannerImage: $resources.images.landscape
  privacyPolicyUrl: http://path/to/privacy/policy
  sampleInvocations:
  - Talk to My Display Name
  shortDescription: short description of the action

  smallLogoImage: $resources.images.square
  voice: female_1
...

音声ファイル

音声ファイルは resources/audio/ に保存され、参照できます $resources.audio.<name of the audio file without file extension> に置き換えます。

使用できるファイル拡張子は次のとおりです。

mp3
mpeg

たとえば、プロンプトから音声録音を参照できます。

candidates:
  - first_simple:
      variants:
        - speech: your speech response
    content:
      media:
        mediaType: audio
        mediaObjects:
          - name: media name
            description: media description
            url: $resources.audio.intro

文字列

文字列は .yaml ファイルとして resources/strings/ に保存されます。各ファイルには文字列キーと関連値のマップ（単一の文字列またはリスト）使用します。これらの値は、gcloud SDK の $resources.strings.<name of the image file without file extension>.<key> 単一の文字列値を取得する、またはリストからランダムな値を取得する、 $resources.strings.<name of the image file without file extension>.<key>.<numerical index> 照合する場合に便利です

たとえば、文字列のローカライズにリソース文字列を使用する場合、前の例の sdk/settings/en/settings.yaml は次のようになります。

localizedSettings:
  developerEmail: developer@developers.com
  developerName: $resources.strings.appinfo.developerName
  displayName: $resources.strings.appinfo.displayName
  fullDescription: $resources.strings.appinfo.fullDescription
  largeBannerImage: $resources.images.landscape
  privacyPolicyUrl: $resources.strings.appinfo.privacyPolicyUrl
  sampleInvocations:
  - $resources.strings.invocations.sample
  shortDescription: $resources.strings.appinfo.shortDescription
  smallLogoImage: $resources.images.square
  voice: female_1
...

シミュレータでプロジェクトをテストする

Actions Console には、アクションをプレビューするためのシミュレータが用意されています。「シミュレータでは、デバッグ情報の表示、デバイスの機能の設定、シミュレート使用できます。

**図 3.** シミュレータの主な領域は、（1）ユーザー入力、（2）デバイスビュー、（3）オプションと設定、（4）会話ログです。

プロジェクトをテストするには:

gactions deploy preview を実行して、アクションを「preview」にデプロイします。有効にしてシミュレータでテストすることもできます。
コマンド出力の URL を開き、シミュレータにアクセスします。

$ gactions deploy preview
Deploying your project files to your Actions console preview for a project id: "my-project". This may take a few minutes.
Sending configuration files
Waiting for server to respond.
✔ Done. You can now navigate to the Actions Console simulator to test your changes: http://console.actions.google.com/project/my-project/simulator?disableAutoPreview