> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/tech/ja/identity-and-access/agent-team-permissions.md).

# Agent Teams：ロールのリソース権限

Agent Teams のロール別リソース権限を連携し、利用、会話履歴の閲覧、編集、削除を区別します。チームのチャネルを独立した権限の付与元として扱わないようにします。

連携システムからロールに Agent Team を割り当てる場合、権限の付与単位はチームです。チームのエントリー Agent と、その Agent の会話チャネルはチームの権限を引き継ぐため、チャネルごとに権限を個別に割り当てる必要はありません。

たとえば、企業の連携管理者が、カスタマーサービスのロールに特定のチームの利用を許可しつつ、他の人の会話の閲覧やチームの変更は許可しない場合です。まず、そのチームをロールに割り当て、デフォルトの「利用」権限を維持します。管理者が履歴を確認する必要がある場合に、別途「会話履歴の閲覧」権限を付与します。

管理画面での操作方法は、ユーザーマニュアルの [Agent Teams](https://docs.maiagent.ai/build/teams) を参照してください。

## 4 つの権限 <a href="#permission-flags" id="permission-flags"></a>

| 権限フィールド                | 用途                                    | 新規割り当て時のデフォルト値 |
| ---------------------- | ------------------------------------- | -------------- |
| `canRead`              | チームを利用し、エントリー Agent の会話チャネルでチームと会話します | `true`         |
| `canViewConversations` | チームの会話履歴と実行ログを閲覧します                   | `false`        |
| `canUpdate`            | チームのキャンバス、メンバー、エントリー設定を変更します          | `false`        |
| `canDelete`            | チームを削除します                             | `false`        |

{% hint style="warning" %}
会話履歴の閲覧、編集、削除はいずれも「利用」権限に依存します。権限の更新時に `canRead` を無効にする場合は、残りの 3 つの権限も同時に無効にする必要があります。そうしないと、リクエストは拒否されます。
{% endhint %}

メンバーが複数のロールに所属する場合、同じチームに対する 4 つの権限は、それぞれ各ロールの和集合で決まります。1 つのロールの権限付与を削除しても、メンバーが必ずアクセス権を失うとは限らないため、他のロールも確認する必要があります。組織のオーナーは 4 つすべての権限を持ちます。

## 割り当てと更新 <a href="#assign-and-update" id="assign-and-update"></a>

以下のパスは `/api/organizations/{organizationId}/groups/{groupId}/group-teams/` 配下の相対パスです。`{grantId}` は権限付与レコードの ID であり、チーム ID とは異なります。

| メソッド     | 相対パス           | 用途                                                       |
| -------- | -------------- | -------------------------------------------------------- |
| `GET`    | ルートパス          | ロールに付与されたチーム権限の一覧を取得します                                  |
| `POST`   | `bulk-create/` | `{"teams":["<teamId>"]}` でチームを割り当てます。割り当て済みのチームはスキップされます |
| `PATCH`  | `{grantId}/`   | 該当レコードの 4 つの権限を更新します                                     |
| `DELETE` | `{grantId}/`   | 該当ロールの権限付与を削除します                                         |

レスポンスの `team` には、チームの `id`、`name`、およびエントリー Agent の `inboxes` が含まれます。これらを使って、そのチーム権限が対象とする会話チャネルを表示できます。権限の更新や削除には、返された権限付与の `id` を使用してください。`team.id` を権限付与 ID として使用しないでください。

割り当て時に指定できるのは、同じ組織内の割り当て可能なチームのみです。ロールはまず呼び出し元の現在の組織内で検索され、別の組織のロールには `404` が返されます。オーナーロールの権限は変更できません。権限付与の一覧取得と書き込みには、「組織概要」権限のチェックも適用されます。

## チーム操作には機能とプランのチェックも適用されます <a href="#feature-and-plan-gates" id="feature-and-plan-gates"></a>

リソース権限は「どのチームで何ができるか」を決定するものであり、機能の有効・無効やプランの利用資格のチェックに代わるものではありません。チームの管理には、引き続きプラットフォームの Agent Teams スイッチとチーム機能の権限が適用されます。チームの作成には、ロールでチームの追加が許可されていることも必要です。チームの作成や削除、エントリーの変更やアップグレードには、Agent Builder のプランチェックも通過する必要があります。

実行ログを読み取るには、まずプラットフォームの機能スイッチと、実行ログへのアクセスに必要な機能権限のチェックを通過する必要があります。その後、チームの利用権限がない場合は `404`、利用権限があっても会話履歴の閲覧権限がない場合は `403` が返されます。

既存の通常の Agent や会話チャネルの権限によって、チームのエントリー Agent やチームのチャネルに追加の権限が付与されることはありません。連携側ではチームの権限を管理してください。チームのチャネルごとに通常のチャネル権限を書き込むと、設定と実際の権限が一致しなくなるため、避けてください。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/tech/ja/identity-and-access/agent-team-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
