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

# 共有とアクセス制御

> ClickHouse Agents の権限モデルとアクセス制御

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>ベータ</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ベータ機能です。 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        詳しくはこちら。
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

ClickHouse Agents は階層化された権限モデルを採用しています。ロールは、ユーザーがどの機能を利用できるかを制御し、リソースレベルのアクセスリストは、特定のエージェントやその他のリソースを利用できるユーザーを制御し、管理者権限は、すべてを管理できるユーザーを制御します。

<div id="roles">
  ## ロール
</div>

ロールは、1人以上のユーザーに割り当てる機能別の権限をまとめたものです。デフォルトのロールは次のとおりです。

* **User** - エージェントの実行とチャットができます。エージェントをビルドできるか、スキルを作成できるか、リソースを共有できるかなどは、ロール内の機能ごとのトグル設定によって決まります。
* **Admin** - User のすべての権限に加えて、組織レベルの管理も行えます。ユーザーの管理、マーケットプレイスの設定、権限の付与が可能です。

Admin は、よりきめ細かく制御できるよう、独自のトグル設定を持つカスタムロールを作成できます。

<div id="resource-sharing">
  ## リソースの共有
</div>

エージェント、プロンプト、スキルには、それぞれアクセスリストがあります。各プリンシパルに対して、3 つのアクセスレベルがあります。

* **Viewer** - リソースは使用できますが、変更はできません。
* **Editor** - リソースの設定 (指示、アタッチされたツール、モデルなど) を変更できます。
* **Owner** - Editor の権限に加え、リソースを削除したり、共有設定を変更したりできます。

リソースを作成すると、デフォルトでその Owner になります。明示的に共有しない限り、そのリソースは自分だけがアクセスできます。

<div id="principals">
  ## プリンシパル
</div>

次の対象にアクセス権を付与できます。

* **個々のユーザー** - 1 回につき 1 ユーザーです。
* **グループ** - チームや組織単位です。ユーザーが後からグループに参加したり離脱したりしても、アクセス権は自動的に更新されます。
* **組織全体** - 組織内の全員がそのリソースを参照できます。これは、その操作を許可するロールレベルのトグル設定に従います。

組織全体で可視化されることで、リソースは [マーケットプレイス](/docs/ja/products/cloud/features/ai-ml/agents/marketplace) で見つけられるようになります。

<div id="share-an-agent">
  ## エージェントを共有する
</div>

エージェントビルダーの下部にある**share**アイコンをクリックします。アイコン上のバッジには、現在アクセス権を持っているユーザーまたはグループの数が表示されます。

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/sharing/sharing.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=d69e0d0dcda49492fd9a0212fcb93cf8" alt="share アイコンが強調表示され、共有先が 1 件あることを示すバッジが表示されたエージェントビルダーパネルの下部" size="sm" width="696" height="1934" data-path="images/cloud/agent-builder/sharing/sharing.webp" />

**Share**モーダルが開きます。名前またはメールアドレスでユーザーまたはグループを検索し、アクセスレベル (**Viewer**、**Editor**、または **Owner**) を選択して、**Save Changes**をクリックします。組織全体に共有するには、**Share with everyone in ClickHouse**トグルを有効にします。

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/sharing/share-agent-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=1153af97349da4397d4fcf2e1428a7b1" alt="User and Group Permissions セクション、検索入力欄、Owner ロールを持つ既存ユーザー、Share with everyone in ClickHouse トグル、Cancel ボタン、Save Changes ボタンがある Share モーダル" size="md" width="1544" height="824" data-path="images/cloud/agent-builder/sharing/share-agent-modal.webp" />

共有相手には、次回更新時に利用可能なエージェント一覧にそのエージェントが表示されます。アクセスを取り消すには、同じモーダルで該当する行を削除します。共有相手は直ちにアクセスできなくなります。進行中の会話は完了しますが、新しい会話は開始できません。

<div id="default-agent">
  ## デフォルトのエージェント
</div>

1 つのエージェントをデフォルトに設定できます。新しい会話は、別のものを選択しない限り、そのエージェントで開始されます。Admin は、まだ自分用のデフォルトを選択していないユーザー向けに、組織全体のデフォルトを設定することもできます。

<div id="admin-operations">
  ## Admin の操作
</div>

Admin のみが実行できる操作には、次のものがあります。

* ロールの作成と編集。
* マーケットプレイスのカテゴリの設定と、注目のエージェントの選定。
* 組織レベルで機能 (Memory、ウェブ検索、コードインタープリター、マーケットプレイスなど) を有効または無効にすること。
* 他のユーザーへの Admin 権限の付与。

ClickHouse Cloud では、Admin パネルは組織の Admin が利用できます。表示されない場合は、アクセス権の付与を依頼するため、組織の Admin または ClickHouse Cloud Support に連絡してください。

<div id="gotchas">
  ## 注意点
</div>

* **エージェントを削除すると、共有はすべて無効になります。** 共有相手はアクセスできなくなります。エージェントとの保存済みの会話は引き続き閲覧できますが、続きはできません。
* **共有中のエージェントを編集すると、それを使っている全員に影響します。** 他の人に影響を与えずに試したい場合は、コピーを使ってください。
* **ユーザーのロールを取り消しても、そのユーザーが作成したリソースは削除されません。** そのユーザーのエージェント、プロンプト、スキルはアクセス一覧に残るため、完全に利用停止する前に所有権を移譲してください。