Slack

Slack は、チーム用の Web ベースのリアルタイム・アーカイブ・メッセージング・アプリケーションです。 オープン・チャネルまたはプライベート・チャネルでのコミュニケーション、ワーク・メンバーへのダイレクト・メッセージの送信、ファイルの共有を行うことができます。 本書では、 IBM watsonx OrchestrateSlack に接続し、そのスキルを watsonx Orchestrateで使用する方法について説明します。

開始前に

watsonx OrchestrateSlackに接続する前に、 Slack ワークスペースがあることを確認してください。 Slack アカウントがない場合は、アカウントを作成し、 SlackSlack ワークスペースを作成して開始することができます。

ワークスペースの Slack URLを保存してください。 watsonx OrchestrateSlack に接続するには、このデータが必要です。

Slack プランについて詳しくは、 チームに適したプランの選択を参照してください。

Slackへの接続

あなたまたはあなたのチームが使用したい資格の種類に応じて、アプリに接続します。

アプリをOrchestrateエージェントのスキルセット、AIアシスタントのスキルセット、またはTeamのスキルセットとTeamの資格情報で接続する場合は、「アプリの接続の管理」 を参照してください。

メンバー資格でアプリを個人スキルセットまたはチームスキルセットに接続する場合は、「アプリへの接続」 を参照してください。

watsonx Orchestrate SaaS での接続の構成

watsonx OrchestrateSlackに接続するには、 「アプリの接続」をクリックします。 これにより、 Slack ワークスペースにサインインし、そのワークスペースへのアクセスを watsonx Orchestrate に許可するようにリダイレクトされます。 受け入れると、 watsonx Orchestrate は自動的に接続します。

注:
  • ブラウザーにアクティブな Slack 接続が既にある場合、その接続が認証に使用されます。 アクティブ接続からログアウトして、別の Slack アカウントに接続します。
  • 緑色のチェック・アイコンが表示され、アプリが接続されていることが示されます。 というアイコンは、接続が正常に確立されたことを示しています。

watsonx Orchestrate on-premises での接続の構成

watsonx OrchestrateSlackに接続するには、以下の手順を実行します。

  1. 「アプリの接続」をクリックします。
  2. 「アクセス・トークン」 フィールドに、Slack アカウントで認証するためのアクセス・トークンを指定します。
  3. 「アプリの接続」をクリックします。

接続値の取得の詳細については、接続値の取得を参照してください。

:アイコン 緑色のチェック・アイコンが表示され、アプリが接続されていることが示されます。 は、接続が正常に確立されたことを示します。

接続値の取得

ステップに従って、 watsonx OrchestrateSlackに接続するための接続値を取得します。

アクセス・トークン

ステップ 1。 Slack アプリの作成

  1. Web ブラウザーで、 Slack アカウントにサインインします。
  2. Web ブラウザーで、 「アプリケーション」ページを開きます。
  3. アプリがない場合は、アクセス・トークンを生成するためのアプリを作成します。
    1. 「アプリの作成」 をクリックし、アプリのスコープと設定の構成を選択します。
    2. アプリを識別するための名前を入力し、リストからワークスペースを選択します。
    3. 「アプリの作成」をクリックします。
  4. 既にアプリがある場合は、 「アプリ」 ページで、アクセス・トークンを生成するアプリをクリックします。

ステップ 2. アプリのリダイレクト URLを定義する

  1. 「フィーチャー」 メニューから、 「OAuth」&「許可」をクリックします。
  2. リダイレクト URL] セクションで、[ 新しいリダイレクト URLを追加 ]をクリックします。
  3. URL https://www.google.com を入力し、[ Add] をクリックし、[ Save URLs ]をクリックします。

ステップ 3。 クライアント ID とクライアント秘密鍵の取得

  1. 「設定」 メニューから、 「基本情報」をクリックします。
  2. 「アプリ資格情報」 セクションで、クライアント ID とクライアント秘密鍵の値をコピーして保存します。

ステップ 4. アプリを許可し、許可コードを取得します

  1. ブラウザーのアドレス・バーに以下のリンクを貼り付けます。 <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
    
  2. アプリを許可するページが表示されたら、 「許可」をクリックします。

  3. アドレスバーの URLから、 code クエリの値をコピーする。 例えば、https://www.google.com/?code=<Code>&state=123456789です。

ヒント:許可コードは、取得後 10 分で有効期限が切れます。 その時間が経過したら、ステップを進めるために新しいコードを取得する必要があります。

ステップ 5. アクセス・トークンの取得

  1. 以下の 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
    
  2. cURL コマンドを実行します。

  3. 応答で、 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を取得するには、以下の手順を実行します。

  1. Slack ワークスペースを開き、ID を取得するチャットを右クリックします。
  2. 会話チャットの場合は 「会話の詳細を表示」 を選択し、チャネル・チャットの場合は 「チャネルの詳細を表示」 を選択します。
  3. 「チャネル ID」をコピーします。 「チャネル ID」 情報が表示されない場合は、チャットの詳細ウィンドウをスクロールします。 「チャネル ID」 はウィンドウの下部にあります。

Slack チャネルを参照すると、アクセントのないチャネルの名前が機能する場合があります。あるいは、 「チャネルの取得 (Retrieve channels)」 スキルを使用してチャネル ID を取得することもできます。

parentType メッセージを投稿するチャネルのタイプ。 以下のいずれかのチャネル・タイプを選択します。
  • channel -メッセージをパブリック・チャンネルまたはプライベート・チャンネルに投稿します。
  • im -ダイレクト・メッセージを投稿します。
  • mpim-自分がメンバーになっている複数のユーザーによるダイレクト・メッセージにメッセージを投稿します。
memberID

メンバー ID を取得するには、以下の手順を実行します。

  1. Slack ワークスペースを開き、個人のプロファイル名またはアイコンをクリックします。
  2. 「完全プロファイルの表示」をクリックします。
  3. メニュー オーバーフロー・メニュー をクリックし、Copy member ID を選択して、その個人のメンバーIDを取得します。

Parse デフォルトでは、システムは、 Parsenoneに設定することによって、メッセージ内のハイパーリンクを削除します。 メッセージ内の URL をハイパーリンクするには、 Parsefullに設定します。
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スキルを使うことができる。 詳しくは、チャットの使い方をご覧ください。

利用可能なスキルについては 、「事前構築済みアプリ、スキル、スキルフローの一覧」 を参照してください。


親トピック:

→ アプリへの接続