生成 AI エラーコードの定義Summary<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } この記事では、Generative AI Controller (GAIC) のエラーコードをステージごとに定義し、それぞれの考えられる回避策を提供します。 すべての LLM 実行後に、sys_generative_ai_log テーブルにログレコードが作成されます。このテーブルには、成功レスポンスと実行中に発生したすべてのエラーが保存されます。エラーは、Generative AI Controller 実行の 3 つのステージである、プリプロセッサー、LLM リクエスト、およびポストプロセッサーのいずれのステージでも発生する可能性があります。 この記事では、各ステージごとのすべてのエラーコードについて、エラーコードの定義と考えられる回避策を含めて説明します。 プリプロセッシング 100001: Min Word Count restriction error. The source doesn't have the minimum number of words required to complete the request. 最終リクエストプロンプトには最小単語数が必要です。プロンプトの単語数は、使用される定義について sys_generative_ai_config テーブルの Min Word Count フィールドと照合されます。このチェックを回避するには、最小単語数を -1 に設定できます (これは新しい生成 AI 設定レコードのデフォルト値でもあります)。 100002: Missing _meta property in the request. GAIC プリプロセッサーに渡される JSON 入力に _meta キーがありません。これは、チームが OneExtend API を経由せずに GAIC サブフローを直接実行する場合によく発生します。 リクエストが GAIC プリプロセッサーに到達する前の処理中にエラーが発生しました。フローコンテキスト実行に移動し、プリプロセッサーに渡されている入力を確認してください。ほとんどの場合、不正な形式の JSON が入力としてプリプロセッサーに送信されています。 これは、Gen AI FDIH サブフローが適切にインストールされないため、HI および BT1 クローンで確認されています。回避策として、この要素の属性を次のように変更します。 変更前 list_layout_ignore=true,model_field=sys_id,record_watcher_blacklist=true,serializer=com.glide.vars.VariableValueXMLSerializer,slushbucket_ref_no_expand=true 変更後 list_layout_ignore=true,model_field=flow,record_watcher_blacklist=true,serializer=com.glide.vars.VariableValueXMLSerializer,slushbucket_ref_no_expand=true 100003: Missing mandatory attributes in the request. リクエストでは、必須としてマークされた capability 属性が必要です。sys_one_extend_capability に移動し、使用している capability のレコードを開きます。OE Capability Attributes タブの下で、リクエストに必須属性が含まれていることを確認してください。 100004: Error occurred while preparing the request. このエラーは、指定された capability 定義に対してアクティブなプロンプト設定が見つからない場合によく発生します。 100005: Error occurred while running request validators in the pre-processor. 指定された capability 定義のリクエストバリデーター (sys_generative_ai_request_validator) で問題が発生しました。 100006: Error occurred while calling the Data Privacy API. GAIC プリプロセッサー中に Data Privacy API がエラーを返しました。Data Privacy API は、個人を特定できる情報 (PII) をマスクするために呼び出されます。詳細については、Data Privacy API エラーコードのドキュメントを参照してください。 LLM リクエスト 200000: Error at the LLM run level. Unknown Host Exception。接続のホスト URL を確認し、それが正しいことを確認してください。 このリソースの API デプロイメントは存在しません。これは、接続に更新された API キーが必要であることを意味します。 NowLLM connection_url にツールキット URL を配置すると、次のエラーが発生するようになります。 "Cannot execute internal HTTP request. Request is not authorized." 回避策として、以下のバックグラウンドスクリプトを使用して is_internal フィールドを false に設定し、このエラーを回避してください。 var gr = new GlideRecord("sys_alias");gr.get("4e85d828777721105de60f207b5a9906");gr.setValue("is_internal", false);gr.update(); 200001: Invalid JSON returned from LLM. json_format_supported フラグが有効になっている場合 (これは使用される定義の sys_generative_ai_config レコードで設定されます)、LLM モデルの出力は JSON 形式で返されることが期待されます。このエラーは、json_format_supported フラグが有効になっているにもかかわらず、LLM レスポンスが JSON 形式ではない場合に発生します。 ポストプロセッシング 300000: Flagged moderation checks in Guardrail response. モデレーションチェック (攻撃的表現またはプロンプトインジェクション) がフラグ付けされました。どのモデレーションチェックがフラグ付けされたか、関連するカテゴリ、およびエラーコードの一覧について、Guardrail レスポンスを確認してください。 300001: Error in Trust Builder response. Trust Builder ポストプロセッサーでエラーが発生しました。詳細については、Flow Designer の GenAITrustBuilderResponsePostProcessor アクションを確認してください。 300002: Error in validating response. 指定された capability 定義のレスポンスバリデーター (sys_generative_ai_response_validator) で問題が発生しました。 300100: Hallucination threshold exceeded for Trust Builder. Trust Builder から返された攻撃性スコアが、sn_generative_ai.hallucination threshold システムプロパティで定義されたしきい値を超えています。詳細については、Flow Designer の GenAITrustBuilderResponsePostProcessor アクションを確認してください。 注: このエラーコードは guardian レスポンスの一部にのみ含まれます 300200: Offensiveness moderation check was flagged. Offensiveness の生レスポンスおよびフラグ付けされたカテゴリについて、sys_generative_ai_metric テーブルを確認してください。 注: このエラーコードは guardian レスポンスの一部にのみ含まれます。 300300: Prompt Injection moderation check was flagged. Prompt Injection の生レスポンスおよびフラグ付けされたカテゴリについて、sys_generative_ai_metric テーブルを確認してください。 注: このエラーコードは guardian レスポンスの一部にのみ含まれます。 その他のエラー 400001: Catastrophic error. サブフローノードのいずれかで致命的なエラーが発生したか、サブフロー実行が完了する前に例外がスローされました。 400002: Error occurred outside the GAIC process. GAIC プロセス外でエラーが発生し、スクリプト可能 API sn_one_extend.GenerativeAIUtility.updateGenerativeAILog() を使用して、元のログレコードが成功からエラーに変更されました。 Related Links<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } }