AI 連携のエラーから復旧する

Core のエラーカタログから生成しています。認可、作用と実際の状態の照合、永続的な冪等性はアプリケーションが担います。復旧ヒントは、再試行を認可するものではありません。

公開インポート

@alneas/appkit-core/ai

import {getAIErrorInfo} from '@alneas/appkit-core/ai';
const hint = getAIErrorInfo('tool', 'INVALID_INPUT');
console.log(hint?.recovery);

action-not-found

action / NOT_FOUND

新しい提案を作成する前に、登録済みアクションと現在の有効期間を確認してください。

action-invalid-input

action / INVALID_INPUT

アクションのバリデーターに従って入力を修正し、承認を求める前に再検証してください。

action-execution-failed

action / EXECUTION_FAILED

再試行を検討する前に、その操作がすでに状態を変更していないか照合してください。

action-cancelled

action / CANCELLED

完了済みの作用を確認してください。キャンセルは書き込みをロールバックしません。

tool-invalid-call

tool / INVALID_CALL

完全な呼び出し ID、公開されたツール名、JSON オブジェクト形式の引数を指定してください。

tool-not-exposed

tool / NOT_EXPOSED

このセッションで明示的に公開されたツールだけを使用してください。追加のツールにはアプリケーションの認可を求めます。

tool-not-available

tool / NOT_AVAILABLE

現在のアクション登録を調査し、対象が変わった場合は新しい提案と承認を取得してください。

tool-invalid-input

tool / INVALID_INPUT

提示されたスキーマと型付きパーサーに従って引数を修正し、修正後の呼び出しに対する承認を取得してください。

tool-cancelled

tool / CANCELLED

完了済みの作用を実際の状態と照合してください。キャンセルはロールバックを意味しません。

tool-execution-failed

tool / EXECUTION_FAILED

再試行前に、操作と権限を照合するようアプリケーションに求めてください。

tool-invalid-output

tool / INVALID_OUTPUT

アプリケーションの出力射影を確認してください。代わりの出力としてハンドラーの生の出力を開示してはいけません。

tool-duplicate-call

tool / DUPLICATE_CALL

元の呼び出し結果をアプリケーションと照合してください。重複防止を回避してはいけません。

tool-call-limit

tool / CALL_LIMIT

このセッションを停止し、アプリケーションで呼び出しの予算を見直してください。

tool-closed

tool / CLOSED

このセッションの使用を停止してください。新しいセッションには、アプリケーション側の認可が必要です。

chat-ai-invalid-configuration

chat / AI_INVALID_CONFIGURATION

信頼されたアプリケーションのエンドポイント、モデル、応答の上限を修正してください。

chat-ai-http-failure

chat / AI_HTTP_FAILURE

アプリケーション側のサービスの可用性と認可を調査してください。再試行前に、不確かな作用を実際の状態と照合します。

chat-ai-invalid-stream

chat / AI_INVALID_STREAM

エンドポイントのプロトコルと会話履歴を、選択したアダプターの契約と照合してください。

chat-ai-incomplete-stream

chat / AI_INCOMPLETE_STREAM

完了したかどうかは不明として扱い、再試行前に保留中の呼び出しを照合してください。

chat-ai-invalid-tool-call

chat / AI_INVALID_TOOL_CALL

不完全または無効な呼び出しを拒否し、元のエンベロープと提示されたスキーマを調査してください。

chat-ai-response-limit

chat / AI_RESPONSE_LIMIT

応答サイズを減らすか、アプリケーションが管理する上限を意図的に見直してください。

chat-ai-file-upload-failure

chat / AI_FILE_UPLOAD_FAILURE

明示的なアップロードハンドラー、受け入れるファイル入力、開示ポリシーを調査してください。

アプリケーション内部の原因情報、プロバイダーの応答本文、認証情報、非公開スキーマの詳細は開示しないでください。AbortError によるキャンセルを維持し、再試行前に不確かな書き込みを調査してください。AI の信頼境界ガイドを参照してください。