コンテナ 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	文字列	会話ベース以外の使用（生成 AI によるナレッジ アシストなど）のセッション ID（省略可）。
show-header	BooleanString	Agent Assist のブランディング ヘッダーを表示するかどうか。デフォルトは "false" です。
show-dark-mode-toggle	BooleanString	ダークモードとライトモードの切り替えを表示するかどうか。デフォルトは "true" です。
namespace	文字列	名前空間の制限（省略可）。1 つのページに複数の UI モジュール インスタンスを実装する場合にのみ必要です。
handoff-summarization-enabled	BooleanString	既存の会話が初期化されたときに、会話の要約を自動的にトリガーするかどうか。デフォルトは "false" です。
handoff-summarization-generator	文字列	引き継ぎの要約のジェネレータ リソース名のオーバーライド（省略可）。形式: projects/{project}/locations/{location}/generators/{generator}。

入力

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

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;

プロパティ名	タイプ	コメント
knowledgeAssistCardConfig	KnowledgeAssistV2Config	生成 AI によるナレッジ アシスト カードの構成（回答のコピー/貼り付け、記事リンクのターゲットのカスタマイズなど）（省略可）。

型

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

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;
}