フックを使用する
フックを使用して、会話ライフサイクルの重要なポイントで Copilot SDK セッションの動作をカスタマイズします。
フックのクイックスタート
ツールの実行の制御、結果の変換、コンテキストの追加、エラーの処理、操作の監査を行う Copilot SDK のフックの使用を開始します。
ツール使用前のフック
onPreToolUseでツールを実行する前に、Copilot SDK フックを使用して、ツールの実行の制御、引数の変更、コンテキストの追加を行います。
ツール使用後フック
onPostToolUseフックを使用して、ツールの結果を変換し、ツールの実行をログに記録し、ツールがCopilot SDKで実行された後にコンテキストを追加します。
ユーザー プロンプト送信後フック
onUserPromptSubmitted フックを使用して、プロンプトの変更、コンテキストの追加、Copilot SDKでのユーザー入力のフィルター処理を行います。
セッションライフサイクルフック
onSessionStartとonSessionEndフックを使用して、コンテキストの初期化、リソースのクリーンアップ、Copilot SDKでのセッション メトリックの追跡を行います。
エラー処理フック
onErrorOccurred フックを使用して、カスタム エラー ログを実装し、エラー パターンを追跡し、Copilot SDKでわかりやすいエラー メッセージを提供します。