Skip to main content

フックを使用する

フックを使用して、会話ライフサイクルの重要なポイントで Copilot SDK セッションの動作をカスタマイズします。

フックのクイックスタート

ツールの実行の制御、結果の変換、コンテキストの追加、エラーの処理、操作の監査を行う Copilot SDK のフックの使用を開始します。

ツール使用前のフック

          `onPreToolUse`でツールを実行する前に、Copilot SDK フックを使用して、ツールの実行の制御、引数の変更、コンテキストの追加を行います。

ツール利用後のフック

          `onPostToolUse`フックを使用して、ツールの結果を変換し、ツールの実行をログに記録し、ツールがCopilot SDKで実行された後にコンテキストを追加します。

ユーザープロンプト送信のフック

          `onUserPromptSubmitted` フックを使用して、プロンプトの変更、コンテキストの追加、Copilot SDKでのユーザー入力のフィルター処理を行います。

セッションライフサイクルフック

          `onSessionStart`と`onSessionEnd`フックを使用して、コンテキストの初期化、リソースのクリーンアップ、Copilot SDKでのセッション メトリックの追跡を行います。

エラー処理フック

          `onErrorOccurred` フックを使用して、カスタム エラー ログを実装し、エラー パターンを追跡し、Copilot SDKでわかりやすいエラー メッセージを提供します。