# ドキュメントの編集/閲覧権限を設定する（ドキュメントごとの設定、フォルダの活用）

## ドキュメント固有の権限の設定 <a href="#document-set-authority" id="document-set-authority"></a>

ドキュメントごとに「アクセスリスト」で閲覧/編集が可能なAlliの管理担当者を設定することができます。

この機能を利用することで、例えば、複数の部門や担当者間でAlliを利用している場合、自身が管理していない領域のドキュメントに対する誤操作（編集や削除など）を防ぐことが可能です。\
ただし、プロジェクトの管理者（管理者権限）はすべてのドキュメントを編集できます。

* 閲覧：ドキュメントの内容とメタデータの読み取り、検索
* 編集：閲覧と編集、削除

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2023/01/image.png?resize=557%2C486&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

アクセスリストはデフォルトでホワイトリスト方式に従います。 つまり、リストに登録されていない担当者は、ドキュメントを編集、閲覧できないことはもちろん、検索を通じてドキュメントの内容を確認することもできません。\
逆に、以下のようにドキュメント検索を活用している場合は、ホワイトリスト方式のアクセスリストを運用は適していません。

* スキルの「ドキュメントから回答」ノードをSDKで活用している場合
* 編集については権限を持つ担当者のみに制限し、閲覧（検索）はすべての担当者に許可したい場合

これを防ぐために、アクセスリストの下にある「リストに含まれないエージェントも閲覧できるようにする」オプションをオンにすると、すべての担当者とSDKユーザーが閲覧権限を持つようになり、すべてのユーザーが権限制限なしで検索することができます。

## 顧客（SDK / APIユーザー）権限の設定 <a href="#customer_permission" id="customer_permission"></a>

担当者の管理と同様に、Q\&Aごとに「アクセスリスト」で閲覧可能なユーザーを管理できます。ここでいう、顧客とは、SDKまたはAPIを介してQ\&Aを検索するユーザーです。顧客はダッシュボードにアクセスできないため、編集権限を持たず、閲覧権限のみを持つことができます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/11/image-4.png?resize=602%2C524&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

顧客アクセスリストもホワイトリスト方式に従います。 したがって、リストに登録されていない顧客には、Q\&A検索時に、そのQ\&Aは検索結果として表示されません。 ただし、アクセスリストの下にある「リストにない顧客（SDK/APIユーザー）も閲覧を許可」オプションをオンにすると、すべての顧客が閲覧権限を持つようになり、検索結果に表示されます。\
担当者を 1 人ずつ追加する必要がある担当者アクセスリストとは異なり、顧客アクセスリストの管理は、顧客個別の追加に加えて顧客グループの追加もサポートします。

個別管理は左側のオプションでcustomer id（user id）を選択後追加、グループ管理はcustomer groupを選択後追加してください。

customer id, customer group これらの変数はすべて顧客固有の変数で、顧客リストから入力できます。特に、顧客グループは入力だけでなく、既存のグループから追加することもできます。

## フォルダを利用した権限の設定 <a href="#folder-set-authority" id="folder-set-authority"></a>

ドキュメントごとに権限を設定しなくても、フォルダを使用して複数のドキュメントの権限を一度に設定できます。

ドキュメントタブ内の「新しいフォルダを追加」、または「すべてのフォルダを表示」をクリックしてフォルダページに進んだ後、「新しいフォルダを追加」ボタンをクリックしてフォルダを追加できます。 フォルダ名とアクセスリストを入力してフォルダを追加してください。

フォルダの閲覧/編集権限もドキュメントと同様に定義されます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/%E3%83%88%E3%82%99%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%95%E3%82%A9%E3%83%AB%E3%82%BF%E3%82%992-2.png?resize=683%2C196&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/%E3%83%88%E3%82%99%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%95%E3%82%A9%E3%83%AB%E3%82%BF%E3%82%993-1.png?resize=677%2C294&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

* 詳細をみる：フォルダ情報を読む（フォルダ内のドキュメントの詳細をみる権限は最終的に各ドキュメントに設定された権限に従い、フォルダ権限とドキュメント権限を同一視するオプションがあります。後述）
* 編集：フォルダの変更
* 削除：フォルダを削除するときは、フォルダ内のドキュメントを削除するかどうかを選択できます。 すべて削除またはフォルダから移動する2つのオプションがあります。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/image-9.png?resize=473%2C146&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

追加（作成）されたフォルダはドキュメントをアップロードするときに選択できます。

既存のドキュメントを移動する場合は、ドキュメントのチェックボックスにチェックを入れ、\
\[その他]メニューの\[ドキュメントを移動する]をクリックすることで、フォルダに移動することも可能です。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/%E3%83%88%E3%82%99%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%95%E3%82%A9%E3%83%AB%E3%82%BF%E3%82%994.png?resize=664%2C328&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

このとき、「選択したフォルダのアクセスリストをドキュメントのアクセスリストに上書きする」オプションをチェックすると、フォルダのアクセスリストがドキュメントのアクセスリストに上書きされます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/image-11.png?resize=473%2C293&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

## その他の有用な情報 <a href="#tips" id="tips"></a>

* フォルダの変更/削除権限は、各フォルダ内に設定されている「編集可能」担当者のリストによって決まります。 フォルダを追加する権限は、プロジェクト設定>エージェント管理>グループ管理>権限の調整で実行できます。

<figure><img src="https://i0.wp.com/guide.allganize.ai/wp-content/uploads/2022/07/%E3%83%88%E3%82%99%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%83%95%E3%82%A9%E3%83%AB%E3%82%BF%E3%82%995.png?resize=638%2C494&#x26;ssl=1" alt=""><figcaption></figcaption></figure>

* フォルダ内にあるドキュメントは、フォルダ内に入った後、そのフォルダのドキュメントリストから確認できます。 フォルダに属していないドキュメントのみがメインページで表示されます。
* 上部の検索バーを使用すると、現在位置しているパス**以下**のみが検索範囲に含まれます。
  * メインページで検索すると、ドキュメント全体で検索可能です
  * 「すべてのフォルダ」ページに入った後に検索すると、すべてのフォルダ内のドキュメントが検索可能、フォルダに含まれていないドキュメントは検索範囲に含まれません
  * フォルダAに入った後に検索すると、フォルダA内のドキュメントが検索が可能です


---

# 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://docs.allganize.ai/alliyzgaido/knowledge-base/document/setting-permissions-for-documents.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.
