> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/ops/experience/custom-metadata-frontend-to-backend.md).

# カスタムメタデータ：フロントエンドと会話AI間で情報をやり取りする

## カスタムメタデータを送信する

ホステッドエクスペリエンスの[customMetadata](https://gitlab.digitalhumans.jp/docs/docs-digitalhumansjp/-/blob/main/development/README.md#custommetadata)または`uneeqInstance.customPromptMetadata()`を使用すると、設定されたデータはユーザー発話時に対話AIに送信され、ログインユーザの識別や、応答を生成する際に使用することができます。

下記はDifyを例にして説明していますが、miiboでも同様に利用できます。

![customMetadata](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-32bce2bae05e945f4ddda39a4ab8ff07a4a6ca5d%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88_2025-06-03_12.04.20.png?alt=media)

customMetadata

![customPromptMetadata()](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-bf87532daa828ea46608afdef5137ca0676fc6d1%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88_2025-06-03_13.12.40.png?alt=media)

customPromptMetadata()

1. フロントエンド ホステッドエクスペリエンスコードスニペットの`uneeqOptions.customMetadata` にパラメータを設定する。 もしくは、`uneeqInstance.customPromptMetadata()`を使用してカスタムデータを動的に設定する。

![](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-efea816a9d1d64e06f6b76c84cd4b80a7e1aa814%2FScreenShot_20250604___11.54.46.png?alt=media)

![](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-8307a0559f888dd7b11495b690d14d955faa2f70%2Fb2e2307a-e863-4bdf-ae57-bf4db2adff26.png?alt=media)

2.接続するDify ChatBotのStartノード入力フィールドで、`customMetadata`や`customPromptMetadata()`に登録したパラメータと同名の入力フィールドを設定して`変数`として定義する。

miiboはStateに登録されるため、自動的に受け取ることができます。 ※ 必須の✓は運用にあわせてください。

![](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-d2b9d70c050fb7c93424eb62a721ab6f3a521075%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88_2025-06-03_13.19.18.png?alt=media)

![](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-6518665b9bc4a537f0177dee14b10750f491fb5b%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88_2025-06-03_12.08.34.png?alt=media)

3.`変数`をプロンプトや処理に埋め込んで使用する。

以上でカスタムメタデータの受け渡しが完了しました。変数を使用することで、ユーザーのIDや属性などを使用した　動的な制御が可能になります。

## カスタムメタデータを更新する

会話AIからフロントエンドへカスタムメタデータを送信するには、`instructions.customMetadata` にキーと値のペア（例：`{'test':'true'}`）を指定します。これにより、`uneeqInstance.setCustomPromptMetadata` が自動的に動作し、カスタムメタデータが更新されます。

この方法でカスタムメタデータを登録した場合、既存のカスタムメタデータは消えず、新しいメタデータが追加される動きになります。もし、同じキーの値が既に存在する場合には、その値が上書きされます。

```json
{
    "instructions": {
        "customMetadata": {
            "test": "true"
        }
    }
}

```

### カスタムメタデータを送信直後の動作

![](https://1399167784-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG1LVgVsXsT2u7A43C1Rg%2Fuploads%2Fgit-blob-f5161f717226c38f1f1130a6786d39743e76987a%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88_2025-06-06_9.58.13.png?alt=media)

`"test": "true"`を会話AIからフロントエンドへ送信して更新すると左図の様なログが出力され、カスタムメタデータが更新されます。ユーザーの発話・リクエストが行われると、`customMetadata` に `"test": "true"`が値で入って会話AIへ届けられます。

更新されたカスタムメタデータは、UneeQイベントの`CustomMetadataUpdate`イベントで取得できます。

## イベントの取得方法

イベントの取得方法については [イベント](/dev/hosted-experience/hosted-experience-events-2.md) をご覧下さい。また、本件には直接関係ありませんが、 [スピーチイベント：発話のタイミングにあわせてイベントを発生させる](https://gitlab.digitalhumans.jp/docs/docs-digitalhumansjp/-/blob/main/settings/experience/hosted-experience-speech-events.md) もあわせてご覧下さい。