Slack
Slack は、チーム用の Web ベースのリアルタイム・アーカイブ・メッセージング・アプリケーションです。 オープン・チャネルまたはプライベート・チャネルでのコミュニケーション、ワーク・メンバーへのダイレクト・メッセージの送信、ファイルの共有を行うことができます。 本書では、 IBM watsonx Orchestrate を Slack に接続し、そのスキルを watsonx Orchestrateで使用する方法について説明します。
開始前に
watsonx Orchestrate を Slackに接続する前に、 Slack ワークスペースがあることを確認してください。 Slack アカウントがない場合は、アカウントを作成し、 Slackで Slack ワークスペースを作成して開始することができます。
ワークスペースの Slack URLを保存してください。 watsonx Orchestrate を Slack に接続するには、このデータが必要です。
Slack プランについて詳しくは、 チームに適したプランの選択を参照してください。
Slackへの接続
あなたまたはあなたのチームが使用したい資格の種類に応じて、アプリに接続します。
アプリをOrchestrateエージェントのスキルセット、AIアシスタントのスキルセット、またはTeamのスキルセットとTeamの資格情報で接続する場合は、「アプリの接続の管理」 を参照してください。
メンバー資格でアプリを個人スキルセットまたはチームスキルセットに接続する場合は、「アプリへの接続」 を参照してください。
watsonx Orchestrate SaaS での接続の構成
watsonx Orchestrate を Slackに接続するには、 「アプリの接続」をクリックします。 これにより、 Slack ワークスペースにサインインし、そのワークスペースへのアクセスを watsonx Orchestrate に許可するようにリダイレクトされます。 受け入れると、 watsonx Orchestrate は自動的に接続します。
- ブラウザーにアクティブな Slack 接続が既にある場合、その接続が認証に使用されます。 アクティブ接続からログアウトして、別の Slack アカウントに接続します。
というアイコンは、接続が正常に確立されたことを示しています。
watsonx Orchestrate on-premises での接続の構成
watsonx Orchestrate を Slackに接続するには、以下の手順を実行します。
- 「アプリの接続」をクリックします。
- 「アクセス・トークン」 フィールドに、Slack アカウントで認証するためのアクセス・トークンを指定します。
- 「アプリの接続」をクリックします。
接続値の取得の詳細については、接続値の取得を参照してください。
接続値の取得
ステップに従って、 watsonx Orchestrate を Slackに接続するための接続値を取得します。
アクセス・トークン
ステップ 1。 Slack アプリの作成
- Web ブラウザーで、 Slack アカウントにサインインします。
- Web ブラウザーで、 「アプリケーション」ページを開きます。
- アプリがない場合は、アクセス・トークンを生成するためのアプリを作成します。
- 「アプリの作成」 をクリックし、アプリのスコープと設定の構成を選択します。
- アプリを識別するための名前を入力し、リストからワークスペースを選択します。
- 「アプリの作成」をクリックします。
- 既にアプリがある場合は、 「アプリ」 ページで、アクセス・トークンを生成するアプリをクリックします。
ステップ 2. アプリのリダイレクト URLを定義する
- 「フィーチャー」 メニューから、 「OAuth」&「許可」をクリックします。
- リダイレクト URL] セクションで、[ 新しいリダイレクト URLを追加 ]をクリックします。
- URL
https://www.google.com
を入力し、[ Add] をクリックし、[ Save URLs ]をクリックします。
ステップ 3。 クライアント ID とクライアント秘密鍵の取得
- 「設定」 メニューから、 「基本情報」をクリックします。
- 「アプリ資格情報」 セクションで、クライアント ID とクライアント秘密鍵の値をコピーして保存します。
ステップ 4. アプリを許可し、許可コードを取得します
ブラウザーのアドレス・バーに以下のリンクを貼り付けます。
<client_id>
をステップ 3 のクライアント ID に置き換えます。https://slack.com/oauth/authorize?response_type=code&state=123456789&client_id=<client_id>&redirect_uri=https://www.google.com&access_type=offline&scope=identify,channels:read,users:read,users:read.email,chat:write:bot,im:read,mpim:read,files:write:user,files:read,groups:read,usergroups:read,chat:write:user,im:write,mpim:write,search:read
アプリを許可するページが表示されたら、 「許可」をクリックします。
アドレスバーの URLから、
code
クエリの値をコピーする。 例えば、https://www.google.com/?code=<Code>&state=123456789
です。
ステップ 5. アクセス・トークンの取得
以下の cURL コマンドから、
<code>
、<client_ID>
、および<client_secret>
の値を、前のステップで取得した独自の値に置き換えます。curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "grant_type=authorization_code&code=<code>&redirect_uri=https://www.google.com&client_id=<client_id>&client_secret=<client_secret>" https://slack.com/api/oauth.access
cURL コマンドを実行します。
応答で、
access_token
キーから値を取得します。以下に例を示します。{ "ok": true, "access_token": "xoxp-6982842894404-...-7116482670706-a18522f88...2dc66f482df133c", "scope": "identify,channels:read,files:read,groups:read,im:read,mpim:read,search:read,users:read,users:read.email,usergroups:read,chat:write:user,chat:write:bot,files:write:user,im:write,mpim:write", "user_id": "X000XXXX0X0", "team_id": "X000XXXX0X0", "enterprise_id": null, "team_name": "Example" }
テクニカル・パラメーター
次の表は、このアプリのいくつかのスキルで必要とされる技術パラメータと、その取得方法を示しています。
パラメーター | 詳細 |
---|---|
Text |
Text フィールドにメッセージを入力することができます。 |
OBJECT_ID |
「メッセージの送信」 スキルには、 Slack上のチャット ID を参照する OBJECT_ID パラメーターが必要です。 OBJECT_IDを取得するには、以下の手順を実行します。
Slack チャネルを参照すると、アクセントのないチャネルの名前が機能する場合があります。あるいは、 「チャネルの取得 (Retrieve channels)」 スキルを使用してチャネル ID を取得することもできます。 |
parentType |
メッセージを投稿するチャネルのタイプ。 以下のいずれかのチャネル・タイプを選択します。
|
memberID |
メンバー ID を取得するには、以下の手順を実行します。
|
Parse |
デフォルトでは、システムは、 Parse を none に設定することによって、メッセージ内のハイパーリンクを削除します。 メッセージ内の URL をハイパーリンクするには、 Parse を full に設定します。 |
Unfurl links |
テキスト・ベースのコンテンツの非表示を有効にするには、 Unfurl links チェック・ボックスを選択します。 |
Unfurl media |
デフォルトでは、メディアへのリンクは非表示になっています。 メディア・コンテンツの解凍を無効にするには、 Unfurl media チェック・ボックスを選択します。 |
Icon URL |
メッセージと一緒にプロフィール写真として使用したい画像の URL。 |
Icon emoji |
メッセージの横にあるプロファイル写真として絵文字を使用するには、コロンのショート・コードを使用して値を指定します。 例えば、絵文字を設定するには、 :white_check_mark: を使用します。 Icon emoji 値は Icon URL をオーバーライドし、指定された絵文字をプロファイル写真として表示します。 |
Thread timestamp |
メッセージを応答にするために、別のメッセージのタイム・スタンプ値を指定することができます。 タイム・スタンプ値は、2 つのメッセージ間の接続を有効にし、指定されたタイム・スタンプを持つメッセージに対する応答であることを示します。 |
Reply broadcast |
Reply broadcast は、返信をチャンネルまたは会話のすべてのユーザーから閲覧可能にするかどうかを示します。 デフォルトでは、この値は false に設定されています。これは、返信がすべての参加者にブロードキャストされないことを意味します。 ただし、このチェック・ボックスを選択すると、返信をすべてのユーザーから閲覧可能にすることができます。 |
次のタスク
アプリに接続したら、「Slackスキルを使うことができる。 詳しくは、チャットの使い方をご覧ください。
利用可能なスキルについては 、「事前構築済みアプリ、スキル、スキルフローの一覧」 を参照してください。
親トピック: