Dialogflow には、多数の一般的なデータタイプに対応する事前に定義されたシステム エンティティが用意されています。たとえば、日付、時刻、色、メールアドレスなどを照合するシステム エンティティがあります。カスタムデータを一致させる独自のカスタム エンティティを作成することもできます。たとえば、食料品店エージェントで購入可能な野菜の種類に一致する野菜エンティティを定義できます。
エンティティの用語
エンティティという用語は、このドキュメントおよび Dialogflow CX コンソールでエンティティの一般的なコンセプトを説明する目的で使用されています。 エンティティの詳細を説明するときには、より具体的な用語を理解しておくことが重要です。
エンティティ タイプ: ユーザー入力から抽出する情報のタイプを定義します。 たとえば、「野菜」はエンティティ タイプの表示名になり得ます。 Dialogflow CX コンソールの [エンティティ タイプ] セクションで [作成] をクリックすると、エンティティ タイプが作成されます。 API を使用する際は、エンティティ タイプという用語が、
EntityTypeタイプを指します。EntityType リファレンスのプロトコルとバージョンを選択:
プロトコル V3 V3beta1 REST EntityType リソース EntityType リソース RPC EntityType インターフェース EntityType インターフェース C++ EntityTypesClient 利用できません C# EntityTypesClient 利用できません Go EntityTypesClient 利用できません Java EntityTypesClient EntityTypesClient Node.js EntityTypesClient EntityTypesClient PHP 利用不可 利用できません Python EntityTypesClient EntityTypesClient Ruby 利用不可 利用できません （省略可）説明: エンティティ タイプの目的を説明します（ 例: 「ユーザーが野菜について言及したときにこのエンティティがトリガーされます」）。AI 生成を使用して参照値の類義語を自動生成する場合は、このフィールドがモデルで使用され、より高品質の結果が生成されます。
エンティティ エントリ: エンティティ タイプごとに多数のエンティティ エントリを設定できます。各エンティティ エントリには、同義とみなされる単語やフレーズのセットが用意されています。最初の列に参照値 、2 番目の列にその参照値の 1 つ以上の類義語 を指定します。たとえば、野菜が エンティティ タイプの場合、次のようなエンティティ エントリを定義できます。
参照値 類義語 新玉ねぎ 新玉ねぎ、分葱 ピーマン ピーマン、パプリカ carrot carrot ジャガイモ ジャガイモ、ポテト、イモ エンティティ エントリと類義語を手動で入力する代わりに、新しいエンティティ エントリを作成するときに [エンティティごとに __ 個の類義語を自動生成する] チェックボックスをオンにできます。デフォルト値は 3 個の類義語です。AI は、参照値とエンティティ タイプの説明に基づいて類義語を生成し、テーブルに入力します。類義語リストには、その値と一致させるために元の参照値も含める必要があります。
Dialogflow CX コンソールでエンティティ タイプを編集する場合、表示される各行がエンティティ エントリ になります。API を使用する際は、 エンティティ エントリという用語が
Entityタイプ（EntityType.EntityまたはEntityType_Entity一部のクライアント ライブラリ言語の場合）を指します。エンティティ参照値と類義語: エンティティ エントリの中には、複数の単語や語句が含まれる場合があります。 前の例の新玉ねぎのように、同等と見なされます。 これらのエンティティ エントリには、1 つの参照値 と 1 つ以上の類義語 を定義します。