> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ToolSet管理

> Jinba ToolboxコンソールでToolSetの作成、Sandbox環境の設定、パッケージの管理、可視性の制御を行う

**ToolSet**は、共有の実行環境にバンドルされた関連ツールのコレクションです。npmパッケージやDockerイメージのように、ツールをグループ化し、ランタイム依存関係を定義し、semverベースのバージョニングをサポートします。

## ToolSetの作成

<Steps>
  <Step title="ToolSetsに移動">
    組織内でサイドバーの**ToolSets**をクリックします。組織に入ったときのデフォルトページです。
  </Step>

  <Step title="New ToolSetをクリック">
    **New ToolSet**ボタンをクリックします。以下のフィールドを持つ作成フォームが表示されます。
  </Step>

  <Step title="詳細を入力">
    | フィールド           | 説明                                                         |
    | --------------- | ---------------------------------------------------------- |
    | **Slug**        | URL用の識別子（例：`slack-tools`）。作成後は変更できません。                     |
    | **Name**        | 人間が読みやすい表示名（例：「Slack Tools」）。                              |
    | **Description** | このToolSetの機能の簡単な概要。                                        |
    | **Language**    | `TypeScript`または`Python`。コードテンプレートとランタイムを決定します。作成後は変更できません。 |
    | **Provider**    | Sandboxプロバイダー：`E2B`または`Daytona`。作成後は変更できません。               |
    | **Visibility**  | `Public`または`Private`。後から変更可能です。                            |
    | **MCP Server**  | 有効にすると、このToolSetをMCPエンドポイントとして公開します。後から切り替え可能です。           |
  </Step>

  <Step title="作成">
    **Create**をクリックします。ToolSet詳細ページにリダイレクトされ、ツールの追加を開始できます。
  </Step>
</Steps>

## ToolSet詳細ページ

詳細ページは、ToolSetを管理するための中央ハブです。4つのタブで構成されています：

<CardGroup cols={2}>
  <Card title="Tools" icon="wrench">
    ToolSet内のすべてのドラフトツールを一覧表示します。新しいツールの追加、ツールをクリックしてコードエディタを開く、未公開の変更があるかどうかを一目で確認できます。
  </Card>

  <Card title="Versions" icon="code-branch">
    公開済みバージョンの履歴を表示し、新しいバージョンを公開し、アクティブ（デプロイ済み）バージョンを切り替えます。
  </Card>

  <Card title="Packages" icon="cube">
    Sandbox依存関係を管理します。ツールがランタイムで必要とするnpmパッケージ（TypeScript）またはpipパッケージ（Python）の追加・削除を行います。
  </Card>

  <Card title="Environments" icon="lock">
    実行時にツールが利用できる環境変数を管理します。値は暗号化されて保存され、必要に応じて表示できます。
  </Card>
</CardGroup>

## Sandbox設定

すべてのToolSetは、ツールが実行されるSandbox環境を定義します。Sandbox設定は作成時に行います：

* **Language** -- `TypeScript`または`Python`。使用するランタイムと新しいツールに生成されるコードテンプレートを制御します。
* **Provider** -- `E2B`または`Daytona`。Sandboxプロバイダーがコンテナの作成、コードの実行、ライフサイクル管理を担当します。

### パッケージの管理

**Packages**タブに移動して、ランタイム依存関係を管理します。

<Steps>
  <Step title="パッケージの追加">
    **Add Package**をクリックし、パッケージ名を入力します（例：TypeScriptの場合は`axios`、Pythonの場合は`requests`）。オプションでバージョン制約を指定できます。
  </Step>

  <Step title="パッケージの削除">
    一覧のパッケージの横にある削除アイコンをクリックして、Sandbox設定から削除します。
  </Step>
</Steps>

パッケージの変更はドラフト状態に反映されます。更新されたパッケージを本番APIコールに反映するには、**新しいバージョンを公開**する必要があります。

### 環境変数の管理

**Environments**タブに移動して、シークレットと設定値を管理します。

<Steps>
  <Step title="変数の追加">
    **Add Variable**をクリックします。キー（例：`SLACK_TOKEN`）、値を入力し、オプションでシークレットとしてマークします。シークレット値はUIでマスクされます。
  </Step>

  <Step title="編集または削除">
    編集アイコンをクリックして変数の値を更新するか、削除アイコンをクリックして削除します。
  </Step>

  <Step title="シークレットの表示">
    表示トグルを使用して、マスクされたシークレット値を一時的に表示します。表示は変数ごとに行われ、適切な権限が必要です。
  </Step>
</Steps>

環境変数は実行時にSandboxに注入され、`process.env`（TypeScript）または`os.environ`（Python）経由でアクセスできます。

## バージョニングと公開

ToolSetは**セマンティックバージョニング**（例：`1.0.0`、`1.1.0`、`2.0.0`）を使用します。各バージョンは、公開時点のすべてのツールとそのコードの不変スナップショットです。

<Steps>
  <Step title="変更を行う">
    ドラフト状態でツールの編集、新しいツールの追加、またはパッケージの更新を行います。
  </Step>

  <Step title="バージョンを公開">
    Versionsタブで**New Version**をクリックします。バージョン番号（コンソールが次のパッチバージョンを提案します）とオプションのリリースノートを入力し、**Publish**をクリックします。
  </Step>

  <Step title="アクティブバージョンの設定">
    最新の公開バージョンが自動的にAPIおよびMCPコールで使用される**アクティブ**バージョンになります。バージョン一覧の任意のバージョンにカーソルを合わせ、**Set as Active**をクリックしてアクティブバージョンを切り替えることができます。
  </Step>
</Steps>

<Note>
  公開済みバージョンは不変です。変更を行うには、ドラフトツールを編集して新しいバージョンを公開してください。
</Note>

## 可視性設定

ToolSetの可視性は、誰がツールを発見・実行できるかを制御します：

| 可視性            | 発見             | 実行                        |
| -------------- | -------------- | ------------------------- |
| **Private**    | 組織メンバーのみ       | 組織メンバーのみ（セッションまたはAPIキー経由） |
| **Public**     | Exploreページで誰でも | 有効なAPIキーを持つすべての組織         |
| **Restricted** | 一般には非公開        | 明示的に許可された組織のみ             |

可視性を変更するには、ToolSetヘッダーの可視性トグルを使用します。**Public**への変更は、ツールスキーマがExploreページで表示されるようになるため確認が必要です（ソースコードは共有されません）。

## MCP Server

ToolSetで**MCP Server**を有効にすると、コンソールにコピー可能なMCP接続エンドポイントURLが表示されます。Model Context Protocolをサポートするエージェントやクライアントは、このエンドポイントに直接接続して、ToolSet内のツールを発見・呼び出すことができます。

MCPのオン・オフはToolSetヘッダーからいつでも切り替え可能です。

## インポートとエクスポート

ToolSet詳細ページでは、zipベースのインポートとエクスポートをサポートしています：

* **エクスポート** -- すべてのツール定義、コード、メタデータを含む`.zip`アーカイブをダウンロードします。バックアップや移行に便利です。
* **インポート** -- `.zip`アーカイブをアップロードして、ToolSetにツールを一括インポートします。スラッグが一致する既存のツールは更新されます。

## ToolSet設定の編集

ToolSetヘッダーの設定/編集リンクをクリックして、編集ページに移動します。以下の操作が可能です：

* **Name**と**Description**の変更。
* **Visibility**設定の変更。
* **MCP Server**のオン・オフの切り替え。

**Language**、**Provider**、**Slug**は作成後に変更できません。

## ToolSetの削除

ToolSetヘッダーの**Delete**をクリックします。すべてのツール、バージョン、関連する実行記録が完全に削除されることを警告する確認ダイアログが表示されます。この操作は元に戻すことができません。