【Semantic Kernel】SlackのData Access APIで社内AIアシスタントにプライベートチャンネルの情報を参照させてみる

Posted at 2025-05-09

こんにちは。

テックリードのTerukiです。

前回、Semantic Kernelを使って社内向けAIアシスタントを作ったという記事を書きました。

これだけでも結構便利ですが、Slack上にある使用者本人にしか見えない情報を使ってSlack内を検索できると結構捗ることもあると思うので試してみます。

Data Access API

長々と書いてありますが、ようは下記のAPIを呼べるようにするための仕組みと私は理解しています。

このAPIはBOTのアクセストークンとは別に短時間だけ使える専用のトークン(action_token)を必要とします。

APIドキュメントにはOptionalと書かれていますが、実際は必須です。

このAPIはAIアシスタントユーザーが見れるプライベートチャンネルやDMを検索対象にすることができるので、Slack内の情報を使って何かさせるなら便利です。

尚、Data Access APIは記事執筆時点ではクローズドBetaのような状態なので、使うためには申請が必要です。

私は feedback@slack.com にメールでお願いしたら案内してもらえました。

メールをしてから使えるようになるまではだいたい2週間ほどかかりました。

申請が通ると、特定のイベントにaction_tokenが含まれるようになります。

検索してみる

まずは普通に検索してみます。

こんなKernelFunctionを書いてみました。

[KernelFunction]
[Description("""
    Slack内のメッセージを検索する
    """)]
public async Task<List<AssistantSearchContextResultMessage>> SearchSlackAsync([Description("検索クエリ")] string searchQuery) {

    if (Context.ActionToken is null) {
        throw new ArgumentException("action_tokenがないので実行できません");
    }

    var result = await SlackApiService.AssistantSearchContextAsync(searchQuery, Context.ActionToken, "public_channel,private_channel").ConfigureAwait(false);

    return result.Results.Messages;
}

シンプルに検索してくるAPIです。

アクショントークンはプラグインのコンストラクタから無理やり渡してきています。

リンクもいい感じに取ってきてくれています。

尚、プライベートな情報を検索するには各自で権限を付与する必要があります。

もうちょっと面白いことをしてみる

これだと検索できただけなのでもうちょっといろいろやってみたいです。

assistant.search.contextにはチャンネルを絞る機能があるのでそれを使ってみます。

times_terukiというチャンネルがあるのでそれを要約してもらいます。

KernelFunctionを少し変更。

[KernelFunction]
[Description("""
    Slack内のメッセージを検索する
    """)]
public async Task<List<AssistantSearchContextResultMessage>> SearchSlackAsync([Description("検索クエリ")] string searchQuery,
        [Description("検索対象のチャンネル。対象を絞らない場合はnull。正規表現パターン: ^[CGDZ][A-Z0-9]{8,}$")] string? contextChannelId) {

    if (Context.ActionToken is null) {
        throw new ArgumentException("action_tokenがないので実行できません");
    }

    var result = await SlackApiService.AssistantSearchContextAsync(searchQuery, Context.ActionToken, "public_channel,private_channel").ConfigureAwait(false);

    return result.Results.Messages;
}