コンテナ V2

コンテナ V2 は、最初のコンテナから大幅に改善されています。最も効果的な提案と重要なツールをエージェントが常に利用できるように、バージョン 2 では、動的パネルと提案の統合フィードを備えたリアクティブなディスプレイが使用されています。

用途

次のコードを使用して、HTML ページにモジュールをインポートします。

<script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

次のタグを使用してモジュールを埋め込みます。

<agent-assist-ui-modules-v2>

UI モジュール コネクタ

V1 とは異なり、V2 では UI モジュール コネクタを個別に初期化する必要があります。コネクタをコンテナから切り離すことで、統合の柔軟性が高まります。設定については、UI モジュール コネクタをご覧ください。V1 コンテナのプロパティの多くは、UI モジュール コネクタにのみ適用されます。

ローカライズ

V2 コンテナはローカライズされた言語をサポートしています。特定の言語でコンテナを読み込むには、スクリプトパスの先頭にロケールコードを追加します。

日本語の例:

<script src="https://www.gstatic.com/agent-assist-ui-modules/ja/v2/container.js"></script>

ロケールが指定されていない場合、コンテナはデフォルトで英語(en)になり、ルートパスから読み込まれます。 html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

サポートされている言語 / 地域:

  • アラビア語(ar)
  • 中国語(簡体)(zh_cn)
  • クロアチア語(hr)
  • 英語(オーストラリア)(en_au)
  • 英語(カナダ)(en_ca)
  • 英語(英国)(en_gb)
  • フィリピン語(fil)
  • フランス語(fr)
  • フランス語(カナダ)(fr_ca)
  • ドイツ語(de)
  • ヒンディー語(hi)
  • ハンガリー語(hu)
  • イタリア語(it)
  • 日本語(ja)
  • 韓国語(ko)
  • マレー語(ms)
  • ノルウェー語(no)
  • ポーランド語(pl)
  • ポルトガル語(ブラジル)(pt_br)
  • ルーマニア語(ro)
  • ロシア語(ru)
  • スペイン語(es)
  • スウェーデン語(sv)
  • タイ語(th)
  • トルコ語(tr)
  • ベトナム語(vi)

属性

属性は、HTML または JavaScript の setAttribute() を使用して設定できる文字列ベースのコンポーネント プロパティです。

プロパティ名 タイプ コメント
機能 文字列 レンダリングする Agent Assist の提案機能キーのカンマ区切りのリスト。サポートされているリスト: AGENT_COACHING、CONVERSATION_SUMMARIZATION、SMART_REPLY、KNOWLEDGE_SEARCH、PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST。use-configured-features が true に設定されている場合は無視されます。
use-configured-features BooleanString features にハードコードするのではなく、会話プロファイルで構成された提案機能を動的に読み込むかどうか。デフォルトは "false" です。
disabled-features 文字列 use-configured-features が "true" の場合に除外する候補機能のカンマ区切りのリスト。例: "SMART_REPLY,CONVERSATION_SUMMARIZATION"
session-id 文字列 会話ベース以外の使用(生成ナレッジ支援サービスなど)のオプションのセッション ID。
show-header BooleanString Agent Assist のブランディング ヘッダーを表示するかどうか。デフォルトは "false" です。
show-dark-mode-toggle BooleanString ダークモードとライトモードの切り替えを表示するかどうか。デフォルトは "true" です。
名前空間 文字列 省略可能な名前空間の上限。1 つのページに複数の UI モジュール インスタンスを実装する場合にのみ必要です。
handoff-summarization-enabled BooleanString 既存の会話が初期化されたときに、会話の要約を自動的にトリガーするかどうか。デフォルトは "false" です。

入力

入力は JavaScript オブジェクトまたは他の複雑なプロパティ型であり、要素インスタンスに直接割り当てる必要があります。

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;
プロパティ名 タイプ コメント
knowledgeAssistCardConfig KnowledgeAssistV2Config 生成ナレッジ支援サービス カードのオプション構成。回答のコピー/貼り付けや記事リンクのターゲットのカスタマイズなど。

型

コンポーネントで使用されるカスタム型については、次のセクションをご覧ください。

BooleanString

"true" | "false"

KnowledgeAssistV2Config

interface KnowledgeAssistV2Config {
  /** Configuration for how suggested article links are opened. */
  articleLinkConfig?: {
    /** Whether to open the article in a new tab or in a popup window. Defaults to 'blank' (new tab). */
    target?: "blank" | "popup";
    /** Options to configure the popup's size and location. */
    popupWindowOptions?: string;
    /** The field name on the document metadata if a separate article link source is provided. */
    linkMetadataKey?: string;
  };
  /** Whether to show the Copy Answer button on suggestions. */
  showCopyAnswer: boolean;
  /** Whether to show the Paste Answer button on suggestions. */
  showPasteAnswer: boolean;
}