メインコンテンツまでスキップ

Slack

SquidにSlackを接続してAIを活用したメッセージを送信​

Slack connectorの機能​

Slack connectorは現在以下の機能をサポートしています:

  • チャネル、グループ、および個々のユーザーへのメッセージ送信。
    • これらの能力をAI agentに提供することで、ユーザーは単にAI agentにメッセージ送信を依頼でき、agentが所望のアクションを実行します。
  • ユーザーはSlackから直接AI agentにメッセージを送ることもでき、Slack connectorがagentの応答をSlack内で直接転送します。
  • connectorは、ボットが追加されているチャネルから全ての会話をナレッジベースに読み込み、ユーザーがAI agentに対してより賢い検索や要約を依頼できるようにします。

Slack connectorの設定​

Squidは、あなたのSlackワークスペース内でメッセージを送受信するために、Slack applicationに接続します。

Slack applicationの作成​

  1. Slack applications のランディングページにアクセスします。
  2. Create New Appをクリックし、意味のあるApp Nameと該当するSlack workspaceを指定してください。

SquidアプリケーションにSlack connectorを追加する​

  1. Squid Console にアクセスし、Connectorsタブを選択します。
  2. Available Connectorsタブに切り替え、Slack connectorを追加します。
  3. 設定の詳細は、先ほど作成したSlack applicationのsettingsページで確認できます:

Connector ID: コード内でconnectorを一意に識別するための意味のある文字列。

App ID: Slack applicationのIDで、Slack appのsettingsのBasic Informationタブで確認できます。

Client ID: Slack applicationのClient IDで、これもBasic Informationタブで確認できます。

Bot User OAuth Token: Slack applicationのBot User OAuth tokenで、OAuth & Permissionsタブで確認できます。このトークンは、Slack APIへのリクエスト認証に使用されます。

Client Secret: Slack appのClient Secretで、Basic Informationタブで確認できます。

Signing Secret: Slack appのSigning Secretで、Basic Informationタブで確認できます。

Verification Token: Slack appのVerification Tokenで、Basic Informationタブで確認できます。

Index Channels: Squidが、ボットが追加されているチャネルから全てのメッセージを読み取り、インテリジェントな検索や要約を提供するかどうか。

Message History Limit: Slack経由でSquidにメッセージ送信する際、Squidはユーザーに最適な回答を提供するために、これだけ前のメッセージを読み込みます。

アプリケーションでのSlack connectorの使用方法​

アプリケーションでSlack connectorを使用する方法は以下の3通りです:

  1. Using the Agent Studio: Agent Studioを使用してAI agentを作成する場合、Add AbilitiesボタンをクリックしてSlack abilityを追加することでSlack connectorを組み込むことができます。Learn more about abilities here。abilityを追加した後、Test AgentタブでagentにSlackメッセージ送信を依頼できます。エージェントを利用してメッセージ検索を試す場合、SquidがSlackメッセージをインデックスするまでに数時間かかることがあります。例:

    • Search Slack for conversations about the product launch
    • Show me all discussions in the Engineering team about API design
    • Find messages in the Finance channel about budget planning

  2. Using the Squid SDK: Squid SDKを使用してAI agentを作成する場合、squid.ai().agent('AGENT_ID').ask()関数を利用してagentと対話できます。Learn more here。ask()関数のconnectedIntegrationsオプションに追加することでSlack connectorを使用できます.

// Configuration to let the agent be aware of the Slack connector.
const config = {
  connectedIntegrations: [{
    integrationId: 'SLACK_CONNECTOR_ID',
    integrationType: 'slack',
    description: 'Call this connector whenever a user asks to send or search Slack messages',
  }]
};

// Send a message.
await this.squid.ai().agent('AGENT_ID').ask('Send a slack message saying "Hello!" to the general channel', config);

// Search messages related to your search.
await this.squid.ai().agent('AGENT_ID').ask('Find messages in the Finance channel about budget planning.', config);
  1. Using the NPM package: @squidcloud/slack-clientを使用する場合、以下が可能です:
// Initialize the client.
const slackClient = SquidSlackClient(this.squid, 'SLACK_CONNECTOR_ID');

// Send a message.
await slackClient.sendMessage({
  recipient: 'general',
  recipientType: 'channel',
  message: 'Hello!'
});

// Find messages related to your search.
await slackClient.searchMessages({
  channelNames: 'general,random',
  prompt: 'need help'
});