コンテンツにスキップ
Documentation

AIエージェントのトラブルシューティング

まず、組み込みのチェックから始めましょう。エージェント内では:

/doctor
/status

シェルから:

Terminal window
champrep version
champrep auth status
champrep ai paths

/doctor インストールされているバージョン、サインイン状況、への接続状況CHAMPREP、 プランにエージェントが含まれているかどうか、および rg (ripgrep) および git が 利用可能か、シェル、およびターミナルの色とサイズを確認します。 /status プロファイル、 環境、モデル、権限モード、およびローカルファイルの場所を表示します。

サポートリクエストには、キーAPI、トークン、または非編集済みのログを貼り付けないでください。

「接続されていません:/login を実行してください」または「サインインされていません」

Section titled “「接続されていません:/login を実行してください」または「サインインされていません」”

アクティブな環境に対して、有効なサインイン情報CLIがありません。

  • 対話モードで、以下を実行してください。 /login または champrep auth login.
  • CI では、以下を確認してください。 CHAMPREP_TOKEN がジョブに対して設定されていることを確認してください。

ヘッドレス実行はコードで終了します 3 この場合は、

ローカルツールの使用は許可されていません

Section titled “ローカルツールの使用は許可されていません”

このメッセージには、ローカルツールには ai:agent スコープ。 認証情報では を使用できますがCHAMPREP AI、エージェントのローカルツールは使用できません。

  • 以下のコマンドで再度ログインしてください: champrep auth login.
  • キーAPIについては、以下を含むキーを作成してください。 ai:agent 名前で指定してください。 より広いスコープのみを持つキーでは不十分です。詳しくは サインイン.

「そのエージェントCHAMPREPCLIは、ご契約のプランに含まれていません」

Section titled “「そのエージェントCHAMPREPCLIは、ご契約のプランに含まれていません」”

ご利用のプランには サービスCHAMPREPCLIが含まれていません。その他 champrep コマンドは引き続き動作します。カード上のリンクを使用してアップグレードするか、 プランと制限.

メッセージに「機能がオフになっている」または「組織の ポリシーで許可されていない」と表示される場合は、組織の管理者がこれを制御しています。

レート制限またはターン数超過

Section titled “レート制限またはターン数超過”
  • 「リクエストの送信間隔が短すぎます」: 1分あたりの制限です。待機時間が短い場合、エージェントは 自動的に再試行します。スクリプトでは、ヒントに記載された時間を 待ってから再試行してください。
  • 「この期間のプランに含まれるすべての利用枠を使い切りました」: アドオンを購入するか、次の請求期間までお待ちください。ループ、サブエージェント、およびCI実行はすべて ターン(実行枠)を使用するため、ご確認ください /tasks まだ実行中のものがないかご確認ください。

モデルがツールを使用できません

Section titled “モデルがツールを使用できません”

「」とマークされたモデルを選択した場合 no tools、エージェントはチャットは可能ですが、 ファイルの読み取り、コマンドの実行、および CHAMPREPサービスの利用はできません。切り替えるには、 /model auto または、マークが付いたモデルを選択してください tools in /models。画像入力などの機能が モデルにないためにターンが拒否された場合は、表示されたオプションから「Auto」または別のモデルを 選択してください。詳しくは モデル.

プロジェクトのコマンド、ルール、または MCP サーバーが無視されます

Section titled “プロジェクトのコマンド、ルール、または MCP サーバーが無視されます”

内容 .champrep/ リポジトリを信頼するまでは、非アクティブのままとなります。「この プロジェクトを信頼するまで、allowルールおよびdefaultModeは無視されます」といった 警告が表示される場合は、プロジェクトの設定は検出されましたが、適用されていないことを意味します。

/trust
/trust approve

拒否ルールは常に適用されます。詳しくは リポジトリの信頼.

初期リリースからのアップグレード後に「no such host」エラーが発生する場合

Section titled “初期リリースからのアップグレード後に「no such host」エラーが発生する場合”

初期のリリースでは、使用されなくなったゲートウェイアドレスが config.toml。現在のリリースでは、設定を読み込む際に自動的に置き換えられます。 それでもエラーが続く場合は:

Terminal window
champrep config env
champrep config path

アクティブな環境のURLAPIがCHAMPREP API GatewayでありCHAMPREPAPI Gateway、 カスタムアドレスや古いアドレスではないことを確認してください。組み込みのデフォルトに戻すには、 その環境のセクションを config.toml; これにより、次回実行時に組み込みの 環境が復元CLIされ、再度サインインすることになります。

ファイルが「シークレットポリシーによってブロックされている」場合

Section titled “ファイルが「シークレットポリシーによってブロックされている」場合”

そのファイルは、組み込みのシークレットリスト、またはご自身の deny_read ルールに従ってください。 これにより、エージェントが内容を読み取れなくなります。これは意図的な仕様です。機密情報以外の部分を 別のファイルにコピーするか、次のようなサンプルファイルをご利用ください。 .env.example。詳しくは 秘密情報の保護.

local_grep を使用します rg (ripgrep)がインストールされている場合はそれを使用し、そうでない場合は 処理速度の遅い組み込みの検索機能に切り替わります。ripgrepをインストールして、再度実行してください。 /doctor.

対話型エージェントは、スクリプト内では起動しません

Section titled “対話型エージェントは、スクリプト内では起動しません”

対話モードではターミナルが必要です。スクリプトやCIでは、以下を使用してください。 champrep ai -p。 詳しくは ヘッドレスおよびCIでの使用.

設定やログはどこにありますか?

Section titled “設定やログはどこにありますか?”
Terminal window
champrep ai paths

これにより、設定、 編集済みのデバッグログ、チェックポイントなど、エージェントが使用するすべてのローカルファイルとフォルダが表示されます。以下のコマンドを実行してくださいCLI。 --debug 詳細な ログを確認できます。エージェントに特有ではない問題CLIについては、 CLI トラブルシューティング.