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

# Kameleoon Slackエージェントを設定する

> KameleoonのSlackエージェントをSlackワークスペースにインストールし、要求される権限を確認します。

チャンネルで実験に関する質問が出ると、誰かが会話を離れて、Kameleoonで答えを探す必要があります。Kameleoon Slackエージェントは、Kameleoonのドキュメントとコードベースを解析して質問に答えるSlackアプリです。設定するには、Slackワークスペースにアプリを追加する権限と、チームで使いたい各チャンネルへの招待が必要です。その後、チームメンバーはSlack内でエージェントに質問し、Slackを離れることなく回答を得られます。

## Kameleoon Slackエージェントをワークフローに組み込む

* **権限**: インストールを承認する前に、エージェントが読み取りと投稿をできる内容を確認します。
* **インストール**: **Add to Slack**ボタンまたは共有可能なリンクから、エージェントをSlackワークスペースに追加します。
* **チャンネルでの使用**: エージェントをチャンネルに招待し、メッセージでメンションします。
* **ダイレクトメッセージでの使用**: エージェントに新しいメッセージを作成し、質問を送信します。

## 始める前に

* **ワークスペースへのアクセス**: アプリを追加できるSlackワークスペース、または代わりにアプリを追加できるSlack管理者。
* **Kameleoonアカウント**: エージェントを使用するためにアカウントは必要ありません。

## ワークスペースでエージェントがアクセスできる内容

Slackは、エージェントをインストールする際にこれらの権限を表示します。各権限は、エージェントがワークスペースで読み取りまたは投稿できる内容を定義します。インストールでは6つすべての権限が要求されます。

| 権限 | エージェントができること |
| - | - |
| `app_mentions:read` | エージェントが参加している会話で、エージェントへのメンションを含むメッセージを読み取る。 |
| `commands` | ショートカットとスラッシュコマンドを追加する。 |
| `chat:write` | エージェントとしてメッセージを投稿する。 |
| `groups:history` | エージェントがメンバーになっているプライベートチャンネルのメッセージを読み取る。 |
| `im:history` | エージェントとのダイレクトメッセージを読み取る。 |
| `assistant:write` | App Agentとして動作する。 |

エージェントがプライベートチャンネルのメッセージを読み取るのは、誰かがそのチャンネルにエージェントを招待した後だけです。チームがエージェントにそのチャンネルのメッセージを読ませることに同意する場合にのみ、プライベートチャンネルに招待してください。

## ワークスペースにエージェントをインストールする

エージェントのインストール方法は2つあります。このページの**Add to Slack**ボタンと共有リンクは、どちらも同じSlackの認証ページを開きます。ワークスペースにアプリを追加できる場合はボタンを使用してください。Slack管理者がエージェントをインストールする必要がある場合はリンクを使用してください。

### このページからエージェントを追加する

管理できるワークスペースにエージェントをインストールするには、**Add to Slack**ボタンを使用します。

[![Add to Slack](https://platform.slack-edge.com/img/add_to_slack.png)](https://slack.com/oauth/v2/authorize?client_id=3308204133.11497023331330\&scope=app_mentions:read,commands,chat:write,groups:history,im:history,assistant:write\&user_scope=)

1. **Add to Slack**をクリックします。
2. エージェントをインストールするワークスペースを選択します。
3. Slackの認証ページで権限を確認してから、承認します。

### インストールリンクをSlack管理者に共有する

ワークスペースにアプリを追加できない場合は、共有可能なインストールURLを使用して、Slack管理者にエージェントをインストールしてもらいます。

URLをコピーして、Slack管理者に送信します。

```text theme={null}
https://slack.com/oauth/v2/authorize?client_id=3308204133.11497023331330&scope=app_mentions:read,commands,chat:write,groups:history,im:history,assistant:write&user_scope=
```

管理者はURLを開き、ワークスペースを選択して、権限を承認します。

## チャンネルでエージェントを使用する

チャンネルでは、エージェントはメンバーになっている場合にのみ、メンションに応答します。Slackは、エージェントが参加していないチャンネルからのメンションを配信しません。そのため、チームがそのチャンネルでエージェントをメンションする前に、各チャンネルにエージェントを招待してください。

### チャンネルにエージェントを招待する

チームでエージェントを使用したい各チャンネルに、エージェントを招待します。

1. Slackでチャンネルを開きます。
2. `/invite @Kameleoon` と入力し、**Enter**を押します。

### チャンネルでエージェントに質問する

チャンネルのメッセージでエージェントをメンションして、質問します。

1. メッセージ入力欄で `@` を入力し、**Kameleoon**を選択します。
2. 質問を入力して、メッセージを送信します。

エージェントが応答しない場合は、そのチャンネルにエージェントを招待したことを確認してください。

### チャンネルからエージェントを削除する

チャンネルからエージェントを削除するには、Slackでチャンネルから任意のアプリを削除する場合と同じ方法を使用します。Slackは、エージェントが参加していないチャンネルからのメンションを配信しません。そのため、削除後はエージェントがそのチャンネルで応答しなくなります。

## ダイレクトメッセージでエージェントに質問する

チャンネルに投稿せずに、エージェントにダイレクトメッセージで質問します。

1. Slackで **Kameleoon** への新しいメッセージを作成します。
2. 質問を入力して、メッセージを送信します。エージェントを `@` でメンションする必要はありません。

エージェントは同じ会話で応答します。