# スニペット（ベータ）

{% hint style="warning" %}
GitBook では Snippets 機能のメンテナンスはすでに終了しており、変更される可能性があります。コンテンツを次のように構成することをおすすめします。 [スペース](/docs/documentation/ja-gitbook-documentation/creating-content/content-structure/space.md) の代わりに行うことをおすすめします。
{% endhint %}

{% hint style="info" %}
この機能は、ProプランとEnterpriseプランの一部として利用できます。詳細については、 [料金ページをご覧ください](https://www.gitbook.com/pricing).
{% endhint %}

GitBookでは、次のものを使って非構造化情報を取り込むことができます。 [連携](https://github.com/GitbookIO/public-docs/blob/main/snippets/broken-reference/README.md)、そしてGitBook AIがそれを **スニペット** に変換します。スニペットとは、読みやすく理解しやすい、構造化された情報ページです。アプリ内で手動でスニペットを作成することもできます。

GitBookは、他のコンテンツとあわせてすべてのスニペットをインデックス化し、あなたやチームが [情報を検索するとき](/docs/documentation/ja-gitbook-documentation/creating-content/searching-your-content.md)に参照できます。スニペットを既存のドキュメントやコンテンツに統合して、すべてを最新の状態に保つこともできます。

### 製品デモ

{% embed url="<https://www.youtube.com/watch?v=P-ZRw0Yh_Mc>" %}
スニペット製品デモ
{% endembed %}

### スニペットを作成する

GitBookでは、使用しているツールや作業しているワークスペースに応じて、さまざまな方法でスニペットを作成できます。

#### サードパーティツールからスニペットを作成する

連携機能を使って、サードパーティツールからスニペットを取り込むことができます。使用しているツールによって、スニペットの追加方法は異なります。サードパーティツールでスニペットを取り込む方法の詳細は、 [連携セクション](https://github.com/GitbookIO/public-docs/blob/main/snippets/broken-reference/README.md).

組織に追加したすべてのスニペットは、最終的に **スニペット** ページに表示され、そのソース、作成者、作成日時などの情報も一緒に確認できます。

#### スニペットを手動で作成する

からスニペットを手動で作成できます。 **スニペット** ページで **自分で作成** カードをクリックします。空白のページが表示され、好きな情報を追加できます。

### スニペットを編集する

キャプチャしたスニペットは、 **スニペット** ページからクリックして開くことで編集できます。これによりエディター画面が開き、誤っている情報を修正したり、不足している内容に追加の文脈を与えたりできます。

### スニペットを共有する

スニペットは、そのスニペットが属する組織への直接リンクとして他の人と共有できます。スニペットを表示すると、 **リンクをコピー** ボタンをクリックします。

### スニペットをページに変換する

スニペットをドキュメント内の完全なページに変換できます。これを行うには、スニペットを開いて **ページに変換** を右上隅で選択します。

ページを配置するスペースの選択を求められます。ドロップダウンメニューでスペースを検索するか、スクロールして選べます。スペースを選択すると、GitBookはスニペットの内容を新しいページとして追加します。あるいは、 [変更リクエストを開く](/docs/documentation/ja-gitbook-documentation/collaboration/change-requests.md) こともできます。これは、選択したスペースが [ロックされたライブ編集](/docs/documentation/ja-gitbook-documentation/collaboration/live-edits.md).

{% hint style="info" %}
**注：** を使用している場合です。スニペットをページに変換すると、GitBookはそのスニペットを自動的にアーカイブします。 [インラインリンク](/docs/documentation/ja-gitbook-documentation/creating-content/formatting/inline.md#links) または [スニペットブロック](/docs/documentation/ja-gitbook-documentation/creating-content/blocks/snippets.md)を使ってスニペットにリンクしていた場合、リンクは引き続き機能しますが、読者は新しいページではなく元のスニペットに移動します。
{% endhint %}

### スニペットを削除する

スニペットを削除するには、 **スニペット** ページでそれをクリックして開き、次に右上隅のアクションメニューから **破棄** オプションをクリックします。

{% hint style="warning" %}
破棄すると、スニペットは完全に削除されます。
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/sunipetto/snippets-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.