Show HN: Channels SDK – どんなエージェントでもどんなチャネルにも(Slack, MS Teams)
Show HN: The Channels SDK – Bring Any Agent to Any Channel (Slack, MS Teams) (github.com)
要約
Channels SDKは、SlackやMicrosoft Teamsなどのワークフローが発生するチャネルに、AIエージェントをネイティブでインタラクティブなUIと共に統合できるツールキットです。このSDKを使用すると、エージェントは自身のツール、モデル、ビジネスロジックを維持したまま、チームが日常的に使用するコミュニケーションプラットフォーム上で動作できます。エージェントは会話を理解し、応答をストリーミングし、ツールを呼び出し、ファイルを操作し、インタラクティブなUIを表示し、人間の承認を待つことができます。
全文翻訳
Channels SDK
AIエージェントをSlack、Microsoft Teams、そして仕事が行われるチャネルに、ネイティブでインタラクティブなUIと共に届けましょう。
Channelsを試す · SDKで構築する · OpenTagを探る
channels-sdk.demo.mp4[動画]
エージェントはツール、モデル、ビジネスロジックを維持します。Channelsは、人々がエージェントと共に働くためのネイティブな場所を提供します。
あなたのエージェントは仕事が行われる場所に属します
Channelsは、AG-UI互換のエージェントを、チームが既に利用しているコミュニケーションプラットフォームに接続します。エージェントは会話を理解し、応答をストリーミングし、ツールを呼び出し、ファイルと連携し、インタラクティブなUIをレンダリングし、人間の承認のために一時停止することができます。
| あなたのエージェントを連れてくる | ネイティブUIをレンダリングする | 人間がコントロールを維持する |
|---|---|---|
| CopilotKitの組み込みエージェントを使用するか、LangGraph、CrewAI、Mastra、Pydantic AI、Google ADK、その他のAG-UIエージェントを接続します。 | メッセージを一度記述するだけで、ネイティブなSlack Block Kit、Teams Adaptive Cards、プラットフォーム固有のUIとしてレンダリングします。 | エージェントがアクションを起こす前に、ボタン、選択肢、承認ゲートを会話に直接配置します。 |
1回のインタラクション、あらゆるチャネルでネイティブに
| Slack | Microsoft Teams | Discord |
|---|---|---|
| [画像: エージェントがバグレポートをトリアージし、Slackで承認を求める] | [画像: エージェントがスプレッドシートを分析し、Microsoft Teamsでメトリクスを返す] | [画像: エージェントがデプロイメントログを読み取り、Discordでチャートをレンダリングする] |
Channelsは、同じエージェントがあらゆるコミュニケーションサーフェスでユーザーと出会える世界のために構築されています。SlackとMicrosoft Teamsの管理された接続はCopilotKit Intelligenceを通じて利用可能で、さらに多くのチャネルが追加される予定です。
ビルドする前に試してみる
アプリ、ランタイム、またはプロバイダーの認証情報を設定することなく、SlackまたはMicrosoft Teamsで実際のChannelsエージェントを体験してください。
Channelsを試す →
プラットフォームを選択し、体験に参加して、エージェントがコンテキスト、ツール使用、ネイティブチャネルUIをどのように処理するかを確認してください。
初めてのチャネルを構築する
あなたのアージェントとアプリケーションロジックは、あなたのインフラストラクチャで実行されます。CopilotKit Intelligenceはプラットフォーム接続を管理し、各ターンをあなたの長時間実行されるChannelsプロセスに配信します。
最速のパス:コーディングエージェントに実行させる
Channelsエージェントの構築は、プロジェクト、エージェント、管理されたチャネル、プロバイダーアプリ、そして長時間実行されるランタイムにまたがります。1つのガイドが、エージェントの全工程を案内します。
npx copilotkit@latest channels setup
これによりchannels-setupスキルがインストールされ、プロンプトが表示され、クリップボードにコピーされます。このプロンプトをコーディングエージェントに貼り付けてください。
このスキルはポインタであり、エージェントが必要としたときにワークフローをcopilotkit.ai/channels-guide.mdから取得するため、インストールされたスキルが古い場合でも手順は最新の状態に保たれます。ガイドは、どのプラットフォーム(SlackまたはMicrosoft Teams)とどのエージェントフレームワークを使用したいかを尋ねます。
エージェントは、あなた自身のサインインセッション内で、SlackとIntelligenceコンソールを自分で操作します。もしブラウザやコンピューター操作ツールをまだ持っていない場合、まずそれらを追加するように求められます。これはフォールバックではなく、意図されたパスです。あなたはシークレットを入力し、エージェントはクリックを行います。
または、Slackセットアップスキルをディスクにインストールする
ホストされたガイドをスキップし、Slackワークフローを既に実行中のコーディングエージェントに直接配置します。
npx copilotkit@latest skills install --skill setup-slack-channel -y
-yは、ピッカーを開かずにそのスキルをインストールします。このスキルはSlackにスコープされています。Microsoft Teamsの場合は、上記のガイドを使用してください。
CLIはIntelligence側をカバーします:copilotkit channels add --adapter slackはチャネルを宣言し、アダプターをアタッチします。copilotkit channels statusは、あなたの設定、コード、サーバーを比較します。ブラウザに残るのは、プロバイダー側です。Slackアプリを作成してワークスペースにインストールすること、およびプロジェクトAPIキーの発行です。CLIフラグは認証情報値を決して受け入れないため、ボットトークンと署名シークレットは.envファイル内に、そしてあなたと共に保持されます。
Unknown option '--skill'? 古いcopilotkit(グローバルにインストールされたもの、またはnpxキャッシュに残っているもの)が現在のCLIをシャドウしています。@latestを維持してください。これがnpxに現在のバージョンを取得させ、既に持っているものを再利用しないようにします。
以下の手順は、手動で行う場合と同じパスです。
1. 接続の設定
CopilotKit Intelligenceでチャネルを作成し、Slackを接続します。次のステップのために、コードとプロジェクトスコープのIntelligence APIキーを保持してください。
Node.js 22以降と、長時間実行されるNodeプロセスまたはコンテナが必要です。
2. SDKのインストール
npm install @copilotkit/channels @copilotkit/runtime
npm install --save-dev tsx typescript @types/node
npm pkg set type=module
ChannelsとRuntimeはペアとして一緒に配布され、テストされています。両方のパッケージを一緒にアップグレードしてください。
3. リスナーの作成
以下の例では、CopilotKitの組み込みエージェントを使用しています。makeAgentを、チャネルライフサイクルを変更せずに、任意のAG-UI互換エージェントファクトリに置き換えてください。
// 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 }],
});
});
const intelligence = new CopilotKitIntelligence({
apiKey: required("INTELLIGENCE_API_KEY"),
});
const runtime = new CopilotRuntime({
agents: {},
intelligence,
identifyUser: () => ({
id: "channels-runtime",
name: "Channels Runtime",
}),
channels: [channel],
});
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)}`);
}
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、異なるエージェントフレームワーク、インタラクティブな承認、ファイル、または本番デプロイメントのガイダンスが必要ですか?Channelsドキュメントで続けてください。
エージェントに実行させたいですか? 上記の最速のパスから
npx copilotkit@latest channels setupを実行してください。ガイドは、この同じセットアップに加えて、プロバイダーと検証の手順をカバーしています。
仕組み
[画像: Channelsアーキテクチャ。あらゆるエージェントをCopilotKitとAG-UI経由でコミュニケーションプラットフォームに接続]
すべてのターンは同じパスをたどります。
- ユーザーがSlackまたはMicrosoft Teamsであなたのアプリにメッセージを送信します。
- CopilotKit Intelligenceがプラットフォームイベントを受信し、あなたのChannelsプロセスに配信します。
- ChannelsはAG-UI上であなたのアージェントを実行し、ツールを実行し、結果をレンダリングします。
- IntelligenceはネイティブプラットフォームUIを会話に送り返します。
| あなたが実行するもの | CopilotKit Intelligenceが管理するもの |
|---|---|
| あなたのアージェント、モデル認証情報、ツール、ビジネスロジック | SlackおよびMicrosoft Teamsのプラットフォーム認証情報 |
| 長時間実行されるChannelsリスナー | プラットフォームのインバウンドおよび認証済み配信 |
| アプリケーションの状態、デプロイメント、ログ | ランタイム登録、ヘルスチェック、再接続 |
SDKはオープンソースでMITライセンスです。CopilotKit IntelligenceはCopilotKitによってホストされるか、エンタープライズデプロイメントのためにセルフホストすることができます。
完全なChannelsアプリを見る
OpenTagは、Channelsで構築されたオープンソースのセルフホスト型オンコールトリアージアシスタントです。
これを使用して、以下の機能を備えた完全なアプリケーションを学習してください。
- AG-UI経由で接続されたPython LangGraphエージェント
- ネイティブなSlackおよびMicrosoft Teamsエクスペリエンス
- ファイル認識プロンプトと生成UI
- LinearまたはNotionへの書き込み前の人間の承認
- 本番環境を想定したNodeランタイムとエージェントサービス
OpenTagソースを探る →
開発者向けリソース
| ~したい場合… | ここから始める |
|---|---|
| セットアップなしでChannelsを体験する | Channelsを試す |
| コーディングエージェントでチャネルを構築する | npx copilotkit@latest channels setup |
| 初めてのチャネルを構築する | Channelsドキュメント |
| SDKの実装を調べる | CopilotKitのChannelsソース |
| パッケージをインストールする | npmの@copilotkit/channels |
| 完全なアプリケーションを調べる | OpenTag |
| 既存のエージェントを接続する | AG-UIインテグレーション |
| プロトコルを理解する | AG-UI |
ライセンス
MIT © CopilotKit