カスタム エンティティ

カスタム エンティティを作成して、エージェント固有のデータをマッチングできます。たとえば、食料品店エージェントで購入可能な野菜の種類に一致する vegetable エンティティ タイプを定義できます。

カスタム エンティティの作成

カスタム エンティティを作成するには、次の手順を行います。

制限事項

次の制限が適用されます。

• カスタム エンティティ タイプの表示名は、エージェントごとに一意です。エンティティ タイプの表示名の先頭は英字にしてください。その後には A-Z、a-z、0-9、_（アンダースコア）、-（ダッシュ）を使用できます。エンティティの参照と類義語の値にこのような制限はありません。

カスタム エンティティのエクスポートとインポート

エンティティをエクスポートおよびインポートして、エージェント間で共有できます。

エクスポート形式のオプションの 1 つは Json パッケージです。これは、ディレクトリと JSON ファイルの階層を含む zip ファイルです。 ディレクトリ構造は次のとおりです。

• entityTypes: このディレクトリにはエンティティ タイプが含まれます。
  • <entity type name>: これらのディレクトリが 1 つ以上存在し、ディレクトリ名はエンティティ タイプの表示名に対応しています。
    • entities: このディレクトリには、エンティティ エントリ ファイルが含まれています。
      • <language tag>.json: これらのファイルが 1 つ以上存在し、ファイル名は言語タグに対応しています。 各ファイルには、言語固有のエンティティ エントリが含まれています。
    • <excludedPhrases>: このディレクトリには、除外フレーズ ファイルが含まれています。
      • <language tag>.json: これらのファイルが 1 つ以上存在し、ファイル名は言語タグに対応しています。 各ファイルには、言語固有のフレーズの除外が含まれています。
    • <entity type name>.json: このファイル名はエンティティ タイプの表示名に対応します。 このファイルには、他のファイルでは見つからないエンティティ タイプ固有のデータが含まれています。

次に例を示します。

folder entityTypes
 ⤷ folder Entity Type A
    ⤷ folder entities
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ folder excludedPhrases
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ insert_drive_file Entity Type A.json
 ⤷ folder Entity Type B
    ⤷ folder entities
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ folder excludedPhrases
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ insert_drive_file Entity Type B.json

エンティティ タイプをインポートする際に、既存のエージェントのエンティティ タイプの表示名がインポートされたエンティティ タイプの表示名と一致すると、マージの競合が発生する可能性があります。 エンティティ タイプの表示名が一致する場合のマージ動作は、次のいずれかを選択して制御できます。

• 既存のエンティティ タイプを置き換える: インポートされたエンティティ タイプは、既存のエージェントにある同じ名前のエンティティ タイプを上書きします。
• 既存のエンティティ タイプとマージする: インポートされたエンティティ タイプのエンティティ エントリは、既存のエンティティ タイプに追加されます。同じエンティティ エントリが存在する場合、重複は発生せず、それらのエントリの下の類義語がマージされます。
• 名前を変更して新しいエンティティ タイプとしてインポートする: インポートされたエンティティ タイプは名前が変更され、表示名に「_1」が追加されます。
• エンティティ タイプをスキップする: 既存のエンティティ タイプは変更されず、インポートしたエンティティ タイプは無視されます。

エンティティ タイプをエクスポートするには:

エンティティ タイプをインポートするには:

エンティティのエントリをインポートする

エンティティ エントリを既存のエンティティ タイプにインポートできます。

エンティティ エントリのインポートに使用されるファイル形式は、エンティティ タイプのインポートに使用される形式と同じです。ただし、インポート ファイルに含めることができるエンティティ タイプは 1 つだけです。また、その下のすべてのエントリが、選択したエンティティ タイプにインポートされます。 同じエンティティ エントリが存在する場合、重複は発生せず、それらのエントリの下の類義語がマージされます。

エンティティ タイプのエンティティ エントリをインポートするには: