> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent と AI

> 一般的な Agent に関する質問—フリーズまたはループした Agent の修正、コストの削減、Agent モード、変更のロールバック、独自の API キーの使用—への回答。

これらの回答は Agent の操作をカバーしています。完全なリファレンスについては、[Agent の概要](/ja/references/agent/overview)、[Agent モード](/ja/references/agent/agent-modes)、[AI 課金](/ja/billing/ai-billing)をご覧ください。

<AccordionGroup>
  <Accordion title="Agent がフリーズするか接続が切れ続けます—どうすれば修正できますか？">
    1. Agent チャットではなく、プロジェクトの **Shell** ペインを開いてください。
    2. `kill 1` と入力して Enter を押し、フリーズしたプロセスを停止してください。（`kill 1` は Replit では安全です—プロジェクトのメインプロセスを再起動するだけで、何も削除しません。）
    3. 新しい Agent チャットを開き、タスクを再度説明して続けてください。

    Agent がフリーズしているように見えるとき、メッセージを送り続けないでください—余分なメッセージは競合する指示を生み出します。Agent が同じタスクでフリーズし続ける場合は、作業をより小さく集中したプロンプトに分割してください。
  </Accordion>

  <Accordion title="Agent がループするか同じステップを繰り返します—どうすれば止められますか？">
    1. Agent パネルの**停止**を選択して直ちに停止してください。
    2. **Shell** ペイン（Agent チャットではない）を開き、`kill 1` と入力して Enter を押してください。
    3. 新しい Agent チャットを開き、タスクをより具体的に言い換えてください。

    ループを避けるには:

    * 大きなタスクをより小さなプロンプトに分割してください—1 メッセージあたり 1 つの目標。
    * [Plan モード](/ja/references/agent/plan-mode)を使用して、Agent が構築する前に作業をスコープしてください。
    * [支出の管理](/ja/billing/managing-spend)で使用制限を設定し、ループが大きな請求を積み上げないようにしてください。
  </Accordion>

  <Accordion title="Agent のコストを削減するにはどうすればよいですか—実際に役立つ設定は何ですか？">
    3 つの設定が最も効果的です:

    * **[エコノミーモード](/ja/references/agent/agent-modes)**—タスクあたりのクレジット使用量を削減し、日常のビルドのデフォルトとして適しています。
    * **[Plan モード](/ja/references/agent/plan-mode)**—Agent が構築する前に作業をスコープして承認し、不要な変更のコストを払わないようにします。
    * **使用制限と予算**—[支出の管理](/ja/billing/managing-spend)でハードキャップを設定してください。

    タスクを切り替えるときに新しい Agent チャットを開始することも役立ちます。使用状況ダッシュボードを確認して、どのタスクが最もコストがかかるかを確認してください。
  </Accordion>

  <Accordion title="Agent モードとは何ですか？それぞれどのように違いますか？">
    Agent には 3 つのトップレベルモードとオプションのスピードトグルがあります。完全なガイダンスについては [Agent モード](/ja/references/agent/agent-modes)をご覧ください。

    * **Lite**—素早いスコープ付き編集のための高速で軽量なモデル。
    * **Economy**—コストに最適化されており、日常のビルドのデフォルトとして適しています。
    * **Power**—複雑なタスクと大規模なコードベースに対応する最も高性能なモデル。
    * **Turbo**—詳細設定のトグルで、Power モードで使用可能。最速のモデルを実行します。大幅に速いですがコストが高いため、意図的に使用してください。

    また、[Plan モード](/ja/references/agent/plan-mode)では、Agent が変更を加える前に作業をスコープし、Build モードでは変更を直接適用します。[Plan モードと Build モードの比較](/ja/learn/plan-vs-build-mode)をご覧ください。Plan モードの推論を含む、すべてのモードがクレジットを使用します。
  </Accordion>

  <Accordion title="Agent が望まない変更を行いました—どのようにロールバックしますか？">
    Replit は Agent が作業中に[チェックポイント](/ja/references/version-control/checkpoints-and-rollbacks)を保存します。Agent チャットで、元に戻したい変更の前のメッセージを見つけ、その隣のロールバックオプションを選択してプロジェクトをその時点に戻してください。

    特定のファイルの回復やライブデプロイメントを含む完全なロールバックオプションについては、[チェックポイントとロールバック](/ja/references/version-control/checkpoints-and-rollbacks)をご覧ください。
  </Accordion>

  <Accordion title="Agent がインターネットや外部 API にアクセスできないと言います—これは想定される動作ですか？">
    ビルドと編集フェーズ中、Agent はアウトバウンドアクセスが制限されたサンドボックス環境で動作します。公開されたアプリは実行時に外部 API 呼び出しを行うことができます—サンドボックスは Agent の編集環境に適用され、実行中のアプリには適用されません。

    実行中のアプリで API 呼び出しが失敗する場合は、キーが [Secrets](/ja/core-concepts/project-editor/app-setup/secrets) ペインに保存されていることを確認し、プロバイダーのステータスページを確認してください。企業や学校のネットワークでは、アプリからのアウトバウンド接続がブロックされている場合があります—ネットワーク管理者に確認してください。
  </Accordion>

  <Accordion title="Agent で独自の API キーを使用できますか？">
    はい。[Secrets](/ja/core-concepts/project-editor/app-setup/secrets) ペインにキーを追加すると、アプリが API 呼び出しにそれらを使用します。**Secrets** ツールを開き、**+ 新しいシークレット**を選択して、名前（`OPENAI_API_KEY` など）と値を入力してください。

    アプリが呼び出すモデルの[独自の AI プロバイダーキーを持ち込む](/ja/references/integrations/replit-ai-integrations)ことができます。Agent エクスペリエンス自体を動かすモデルは Replit のインフラで動作しており、交換することはできません。
  </Accordion>

  <Accordion title="Agent が要求していない機能を追加し続けます—より正確な動作を得るにはどうすればよいですか？">
    より厳密なプロンプトで Agent に集中させてください:

    * *Only*（「のみ」）という言葉から始めてください—例えば、「ユーザーカードに削除ボタンのみを追加してください。他は何も変更しないでください。」
    * [Plan モード](/ja/references/agent/plan-mode)を最初に使用して、Agent が変更を加える前に何をするつもりかを確認してください。
    * Agent が望まない変更をした場合は、すぐに同じチャットで変更を元に戻すよう依頼してください。

    詳細については、[効果的なプロンプト作成](/ja/learn/effective-prompting)をご覧ください。
  </Accordion>
</AccordionGroup>

## お困りの場合は？

こちらで Agent に関する質問が解決しない場合は、[Replit サポートにお問い合わせ](https://replit.com/support)ください。