> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gong-kai/embedding.md).

# 製品に埋め込む

Docs Embed は、製品知識を素早く参照できる強力なウィンドウで、あらゆるプロダクトやウェブサイトに追加できます。ユーザーはに質問することができます [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/notameno-ai/gitbook-ai-assistant.md)。製品から離れることなく、ドキュメントを検索したり、ページを直接閲覧したりできます。埋め込みはボタンで開くことも、任意のコンポーネントに配置することも、完全にプログラムで制御することもできます。

<div data-with-frame="true"><figure><img src="/files/50eddda662ec666a3cc02b333b1885382b23fc4c" alt="Embed GitBook Assistant into your product or website"><figcaption><p>ドキュメントを製品やウェブサイトに埋め込む</p></figcaption></figure></div>

## 概要

Docs Embed には3つのタブを含めることができます:

* **アシスタント**： [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/notameno-ai/gitbook-ai-assistant.md) AI搭載のチャットインターフェースで、ユーザーが答えを見つけるのを支援します
* **検索**：ページをすばやく見つけたり、範囲を限定した質問をしたりするための検索中心の画面
* **ドキュメント**：ドキュメントサイトを閲覧するためのブラウザ

すべてのタブはデフォルトで有効です。 `tabs`を設定すると、埋め込みには指定したタブのみが表示されます。

カスタムアクション、ツール、提案質問、 [認証済みアクセス](/docs/documentation/ja-gitbook-documentation/gong-kai/site-audience/authenticated-access.md)などを使って、デフォルトの設定をカスタマイズし、上書きできます。

## 始める

{% stepper %}
{% step %}
**前提条件**

ドキュメントを埋め込む前に、次を確認してください:

1. **ドキュメントが公開されている** こと、および URL でアクセス可能であること（例: `https://docs.company.com`).
2. **埋め込みスクリプトの URL を取得済みであること** をサイト設定（Settings → AI & MCP → Embed）から。

{% hint style="info" %}
Assistant タブを使用したい場合は、 [GitBook Assistant を有効にする必要があります](/docs/documentation/ja-gitbook-documentation/notameno-ai/gitbook-ai-assistant.md) ドキュメントサイトで（Settings → AI & MCP）。
{% endhint %}
{% endstep %}

{% step %}
**実装**

既存のスタックを使って、GitBook Assistant をすばやく製品に実装するには、当社のスキルをご利用ください。

{% file src="/files/e598c82cf1e0ddfb459a241b4284058a74c255f5" %}

あるいは、以下を読み進めて、あなたの構成に合った方法を選んでください:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-code">:code:</i></td><td><strong>単独の script タグ</strong></td><td>最速でセットアップするには &#x3C;script> タグをそのまま追加し、その後見た目をカスタマイズします</td><td><a href="/pages/030bd959f78b065716d2f9c0dcc1a2879303f264">/pages/030bd959f78b065716d2f9c0dcc1a2879303f264</a></td></tr><tr><td><i class="fa-box">:box:</i></td><td><strong>Node.js/NPM</strong></td><td>サーバーサイドレンダリングやビルド時の制御のために NPM 経由でインストールします</td><td><a href="/pages/8e0e4b951aef9ebc102ed130b49ba602869edd2d">/pages/8e0e4b951aef9ebc102ed130b49ba602869edd2d</a></td></tr><tr><td><i class="fa-react">:react:</i></td><td><strong>React コンポーネント</strong></td><td>事前構築済みの React コンポーネントを使って、シームレスに統合します</td><td><a href="/pages/7523be88446dd47728c7b82cae494686c5fe27d2">/pages/7523be88446dd47728c7b82cae494686c5fe27d2</a></td></tr></tbody></table>

{% hint style="info" %}
ドキュメントで [認証済みアクセス](/docs/documentation/ja-gitbook-documentation/gong-kai/site-audience/authenticated-access.md)を使用している場合は、 [認証済みドキュメントで埋め込みを設定する方法](/docs/documentation/ja-gitbook-documentation/gong-kai/embedding/using-with-authenticated-docs.md).
{% endhint %}
{% endstep %}

{% step %}
**設定**

* [埋め込みのカスタマイズ](/docs/documentation/ja-gitbook-documentation/gong-kai/embedding/configuration/customizing-docs-embed.md) – ウェルカムメッセージ、カスタムアクション、提案を追加する
* [カスタムツールの作成](/docs/documentation/ja-gitbook-documentation/gong-kai/embedding/configuration/creating-custom-tools.md) – Assistant を製品 API に接続する
  {% endstep %}
  {% endstepper %}

## さらに読む

完全な API リファレンスとソースコードについては、 [`@gitbook/embed` GitHub 上のパッケージを参照してください](https://github.com/GitbookIO/gitbook/tree/main/packages/embed).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gong-kai/embedding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.