copilotkit

CopilotKit

CopilotKit ベースのエージェント UX を実装する際に、このスキルを使用します。適切なプロバイダーの接続、ランタイムの選択、共有状態、フロントエンドアクション、中断処理を扱います。

クイックトリアージ

• CopilotKit のプロバイダー設定、ランタイムエンドポイント、フック、共有状態のレンダリング、ヒューマン・イン・ザ・ループ UX には、このスキルを使用します。
• バックエンドのグラフ動作が主な問題の場合は、$langgraph に切り替えます。
• プロトコルイベントへの準拠が主な問題の場合は、$ag-ui に切り替えます。
• コアとなるモデル／ツールのオーケストレーションロジックが主な問題の場合は、$langchain に切り替えます。

ワークフロー

1. ランタイムの構成を選択します。 UI を編集する前に、LangGraph プラットフォームのエンドポイントとリモートバックエンドランタイムのどちらを使うか決めます。
2. プロバイダーの境界を設定します。 まず <CopilotKit> プロバイダーとランタイムエンドポイントの設定を行います。
3. 役割に応じてフックを選択します。 状態の連携には useCoAgent、フロントエンドアクションには useCopilotAction、HITL フローには中断フックを使用します。
4. 共有状態の契約を定義します。 入力／出力／内部状態を分け、シリアライズを安定させます。
5. HITL の経路を実装します。 中断ペイロードを、明示的なフロントエンドアクションハンドラーに対応付けます。
6. 永続化の動作を実装します。 スレッド／メッセージの永続化戦略を選択し、一貫性のある再開を確保します。
7. エンドツーエンドの UX を検証します。 ストリーミング、ツールの表示、共有状態のレンダリング、再開フローをテストします。

デフォルトのパターン

• ランタイムと UI の関心事を分離します。
• 共有状態のスキーマを明示的かつ最小限に保ちます。
• アクションハンドラーを冪等にします。
• 中断は自由形式のメッセージではなく、型付きの制御フローとして扱います。

障害モード

• エンドポイントの不一致（ランタイム URL／タイプの誤り）。
• フックが誤ったエージェント名またはプロバイダーのスコープに紐付けられている。
• スキーマの不一致により、共有状態の更新が反映されない。
• 中断アクションハンドラーが、想定されるペイロードタイプに接続されていない。

リファレンスマップ

現在のサブタスクに必要なものだけを読み込みます。

• ランタイムとプロバイダーの設定：references/runtime-and-provider.md
• フックとアクション：references/hooks-and-actions.md
• CoAgents と共有状態：references/coagents-shared-state.md
• HITL とトラブルシューティング：references/hitl-and-troubleshooting.md