CopilotKit で AI エージェントを Slack や Teams に導入しよう

CopilotKit を活用すれば、Slack、Microsoft Teams、Discord など、実際の業務が行われるチャネルへ AI エージェントを導入できます。ネイティブかつインタラクティブなユーザーインターフェース（UI）を提供し、エージェントはツールやモデル、ビジネスロジックを維持したまま、利用者と対話し続けることが可能です。

導入の概要：ネイティブ UI と人の統制

Channels は、人々と協業するためのネイティブの場所を提供します。

• エージェントの導入:
  • CopilotKit の組み込みエージェントを使用。
  • LangGraph, CrewAI, Mastra, Pydantic AI, Google ADK など、他の AG-UI エージェントとの接続も可能。
• ネイティブ UI のレンダリング:
  • メッセージを記述するだけで、Slack Block Kit や Teams Adaptive Cards などのプラットフォーム固有の UI に変換されます。
• 人の統制:
  • エージェントが行動する前に、ユーザーによる承認ゲートや選択操作を会話内に配置可能で、常に人間のコントロール下におけます。

多チャネル対応と体験環境

Channels は、あらゆるコミュニケーションプラットフォームでエージェントを動作させるように設計されています。

• 対応プラットフォーム: Slack, Microsoft Teams, Discord など。
• CopilotKit Intelligence: Slack および Teams については CopilotKit が接続管理を行い、将来的に更多なチャネルに対応予定です。

構築前の体験環境

アプリ構成やランタイム設定なしで、即座にエージェントを試せます。

• [Channels を試してみる]: プラットフォームを選択し、コンテキスト処理やツール利用を確認できます。

セットアップ：最速のパス（コード生成エージェント）

エージェントとアプリケーションロジックは独自のインフラ上で動作します。CopilotKit Intelligence がプラットフォーム接続を管理し、長期的な実行プロセスへ配信します。

手順：ガイドを使ってセットアップ

プロジェクト作成からランタイム設定までをガイドに任せるのが最も速い方法です。

npx copilotkit@latest channels setup

動作の流れ:

• channels-setup

  スキルがインストールされ、クリップボードにセットアッププロンプトがコピーされます。
• そのプロンプトをコーディングエージェントに貼り付けます。
• 仕組み: 安裝されたスキル（例：数ヶ月前のもの）でも、

  copilotkit.ai/channels-guide.md

  から最新のワークフローを参照するため、常に最新の状態を維持します。
  • ガイドはプラットフォーム（Slack/Teams）やエージェントフレームワークを選択させます。
  • ブラウザやコンピュータ操作ツールの設定がない場合でも、意図されたパスとしてサポートされます。
• 重要: シークレットの入力とクリック操作をあなたが担当し、エージェントはそれらを自動化します。

代替案：CLI だけで Slack をセットアップする ホストされたガイドを使わずに既存のエージェントに直接設定を適用したい場合：

npx copilotkit@latest skills install --skill setup-slack-channel -y

• -y

  フラグ：確認画面なしで即座にインストール。
• 注意：これは Slack 専用です。Teams の場合はガイドを使用してください。

CLI コマンドによる管理:

1. copilotkit channels add --adapter slack

   : チャネルの宣言とアダプター接続。

2. copilotkit channels status

   : 構成、コード、サーバー状態の確認。

注意点: ブラウザではプロバイダーアプリ作成や API キー発行の手動操作が必要です。CLI は認証情報の受け渡しを行わないため、bot トークンなどは

.env

ファイルで管理してください。 トラブルシューティング: 未知のオプション

--skill

が表示される場合は、グローバルにインストールされている古い

copilotkit

の影響がある可能性があります。常に

@latest

を指定してください。

セットアップ：手動による構築手順

完全な制御下でのセットアップ手順です。

1. 接続を構成する

• CopilotKit Intelligence でチャネルを作成し、Slack と接続します。
• 取得した

  Channel Code

  と

  Intelligence API キー

  を保管してください。
• 環境要件: Node.js 22 以降、および長期的に動作する Node プロセスまたはコンテナが必要です。

2. SDK をインストールする

Channels と Runtime はテスト済みペアとして提供されています。両方のパッケージを同時にアップグレードしてください。

npm install @copilotkit/channels @copilotkit/runtime
npm install --save-dev tsx typescript @types/node
npm pkg set type=module

3. リスナーを作成する

channel.ts

makeAgent

channel.ts

import { createServer } from "node:http";
import { createChannel } from "@copilotkit/channels";
import {
  BuiltInAgent,
  CopilotKitIntelligence,
  CopilotRuntime,
} from "@copilotkit/runtime/v2";
import { createCopilotNodeListener } from "@copilotkit/runtime/v2/node";

// 環境変数の確認ヘルパー
function required(name: string): string {
  const value = process.env[name];
  if (!value) throw new Error(`Missing required environment variable: ${name}`);
  return value;
}

// エージェント作成関数
function makeAgent(threadId: string) {
  const agent = new BuiltInAgent({ model: "openai:gpt-5.4-mini" });
  agent.threadId = threadId;
  return agent;
}

// チャネルの定義
const channel = createChannel({
  name: required("CHANNEL_CODE"),
  identifyUser: "platform",
  agent: makeAgent,
});

// メッセージ受信時の処理
channel.onMessage(async ({ thread, message }) => {
  await thread.runAgent({
    prompt: message.contentParts?.length
      ? [
          ...(message.text
            ? [{ type: "text" as const, text: message.text }]
            : []),
          ...message.contentParts,
        ]
      : message.text,
    context: [{ description: "Originating platform", value: message.platform }],
  });
});

// Intelligence の初期化
const intelligence = new CopilotKitIntelligence({
  apiKey: required("INTELLIGENCE_API_KEY"),
});

// ランタイムの初期化
const runtime = new CopilotRuntime({
  agents: {},
  intelligence,
  identifyUser: () => ({
    id: "channels-runtime",
    name: "Channels Runtime",
  }),
  channels: [channel],
});

// Node リスナーの作成
const listener = createCopilotNodeListener({
  runtime,
  basePath: "/api/copilotkit",
});

const channels = listener.channels;
if (!channels) throw new Error("Channels control surface was not created.");

// サーバーとシャットダウン処理
const server = createServer(listener);
const shutdown = async () => {
  await channels.stop();
  if (server.listening) server.close();
};
process.once("SIGINT", shutdown);
process.once("SIGTERM", shutdown);

// チャネルの起動確認
await channels.ready({ timeoutMs: 30_000 });

const status = channels.status();
if (status.overall !== "online") {
  throw new Error(`Channel is not online: ${JSON.stringify(status)}`);
}

// サーバーを起動（ポートは .env で指定可）
const port = Number(process.env.PORT ?? 3000);
server.listen(port, () => {
  console.log(`Channel online; lifecycle server listening on :${port}`);
});

4. 実行を開始する

.env

OPENAI_API_KEY=<openai-api-key>
INTELLIGENCE_API_KEY=<project-api-key>
CHANNEL_CODE=<channel-code-from-intelligence>
PORT=3000

実行コマンド:

node --env-file=.env --import tsx channel.ts

Intelligence が Online と報告したら、アプリを Slack のチャンネルへ招待し、メッセージを送信してください。エージェントはスレッド内で即座に応答します。

必要か？ 上記の手動手順や Microsoft Teams 対応、他フレームワーク連携が不要なら、最速のパス

npx copilotkit@latest channels setup

を実行してガイドに従ってください。

仕組みと責任の分担

各ターンは以下のパスをたどります：

1. ユーザーが Slack または Teams にメッセージを送信。
2. CopilotKit Intelligence がプラットフォームイベントを受け取り、Channels プロセスへ配信。
3. Channels は AG-UI を通じてエージェントを実行し、ツールを起動して結果をレンダリング。
4. Intelligence がネイティブ UI で返信を表示。

責任の分担表

• SDK: オープンソース（MIT ライセンス）。
• Intelligence: CopilotKit によってホストするか、エンタープライズ用にはセルフホスト可能です。

チャンネルアプリの完全版：OpenTag

OpenTag は Channels で構築された、オープンソースのセルフホスト型オンコールトリアドサスタです。研究用として以下の完全なアプリケーションを確認できます。

• AG-UI 経由の Python LangGraph エージェント接続
• ネイティブな Slack および Microsoft Teams 体験
• ファイルに意識的なプロンプトと生成型 UI
• Linear や Notion への書き込み前、人間の承認プロセス
• プロダクション形状の Node ランタイムおよびエージェントサービス

[OpenTag ソースを探索する]

デベロッパーリソース

npx copilotkit@latest channels setup

ライセンス

MIT © CopilotKit