> ## 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.

# コンテキスト管理

> コンテキストウィンドウの仕組みと、Replit Agentで構築する際にAIに適切な情報を与える方法を学びます。

コンテキストとは、AIモデルが次のレスポンスを生成するために使用する情報のことです。コンテキスト管理とは、適切なタイミングでモデルに適切な情報を与える実践のことです。

これが重要なのは、AIはあなたの意図だけからは機能しないからです。コンテキストウィンドウで利用可能なテキスト、ファイル、スクリーンショット、ログ、例、会話の履歴から機能します。

## コンテキストウィンドウとは何か？

AIモデルには一度に考慮できる情報量に制限があります。その制限をコンテキストウィンドウと呼びます。

コンテキストウィンドウには以下を含めることができます：

* あなたのプロンプト
* 会話の以前のメッセージ
* モデルが見ることができるファイルまたはコード
* エラーメッセージとログ
* スクリーンショット、画像、またはデザインリファレンス
* `replit.md`などのプロジェクト指示
* 以前のステップからのツール結果

モデルはそのコンテキストを使用して次に生成するものを決定します。

## コンテキストウィンドウが重要な理由

重要な詳細がコンテキストにない場合、モデルは推測するかもしれません。関係のない情報がコンテキストに多すぎる場合、モデルは間違ったことに焦点を当てるかもしれません。

例えば、このプロンプトはコンテキストをほとんど与えていません：

```text theme={null}
サインアップページを改善してください。
```

このプロンプトは有用なコンテキストを与えています：

```text theme={null}
ウェイトリストへの参加を決めている初めての起業家向けにサインアップページを改善してください。
現在のフィールドはそのままにしてください。フォームの上の価値提案をより明確にしてください。
価格セクションは変更しないでください。
```

2番目のプロンプトは、モデルにページが誰のためか、何を改善するか、何を保持するか、スコープ外は何かを伝えています。

## コンテキストウィンドウのサイズは異なる

異なるAIモデルは異なる量のコンテキストを扱えます。より大きなコンテキストウィンドウは一度に多くのテキストを考慮できますが、大きいことが常により良いわけではありません。すべての詳細を会話にダンプするよりも、関連するコンテキストの方が依然として重要です。

公開されているコンテキストウィンドウサイズの例：

| モデルファミリー          | コンテキストウィンドウの例 |
| ----------------- | ------------- |
| GPT-4.1           | 最大100万トークン    |
| Claude Sonnet 4.5 | 最大20万トークン     |
| Gemini 2.5 Pro    | 最大100万トークン    |

これらの数字は時間とともに変わり、すべての製品が完全なモデルの制限を公開しているわけではありません。実用的な教訓は安定しています：重要な情報を明確で焦点を絞ったものにしましょう。

## コンテキストの種類

| コンテキストの種類     | 例                                     |
| ------------- | ------------------------------------- |
| **目標**        | 「このランディングページはウェイトリストの登録を収集するべきです。」    |
| **オーディエンス**   | 「これは忙しいレストランオーナー向けです。」                |
| **制約**        | 「現在のカラーパレットとフォームフィールドを維持してください。」      |
| **非目標**       | 「まだ支払いを追加しないでください。」                   |
| **例**         | スクリーンショット、モックアップ、サンプルデータ、または競合他社のページ。 |
| **プロジェクトの状態** | 現在のファイル、コンポーネント、エラーメッセージ、またはユーザーフロー。  |
| **完了の定義**     | 「訪問者がフォームを送信してサンクスメッセージを見ることができる。」    |

## フレッシュコンテキストと永続コンテキスト

一部のコンテキストは現在の会話に属します。特定の変更を依頼したり、1つの問題をデバッグしたり、最近の結果にフィードバックを与えるときに使用します。

他のコンテキストはプロジェクト全体で持続すべきです。コーディングスタイル、ブランドガイドライン、命名規則、再利用可能なプロダクトルール、Agentが作業セッションを越えて覚えておくべき制約に永続コンテキストを使用します。Replitでは、[replit.md](/references/project-setup/replit-dot-md)がAgentに永続的なプロジェクトコンテキストを与える1つの方法です。

## コンテキストがノイジーになるとき

長い会話は脱線することがあります。スレッドに多くの無関係な決定が混ざっている場合、Agentはもはや重要でない古いコンテキストに注意を払うかもしれません。

次の場合に新しいスレッドを始めましょう：

* 無関係な機能に切り替えるとき
* 会話に多くの放棄された方向性があるとき
* Agentが古い制約を適用し続けるとき
* 新しい領域の明確なプランが欲しいとき

新しく始めるときは、Agentがまだ重要なことを知っていると仮定するのではなく、重要なコンテキストを要約してください。

```text theme={null}
コンテキスト：このプロジェクトは地元のフィットネスコーチ向けのウェイトリストアプリです。
メインフローはランディングページ → サインアップフォーム → 確認メッセージです。
このスレッドでは、確認メッセージとフォローアップコピーのみを改善してください。
```

## よくある誤解

* **「コンテキストは多いほど良い」** — 関連するコンテキストの方が良いです。無関係なコンテキストが多すぎるとモデルの注意が散漫になります。
* **「モデルはすべてを完璧に覚えている」** — AIは利用可能なコンテキストを使用しますが、重要な制約が重要なときには再述すべきです。
* **「コンテキストはテキストだけ」** — スクリーンショット、ファイル、データ、デザイン、ログ、例はすべてコンテキストになります。

## 次のステップ

<CardGroup cols={2}>
  <Card title="AIの基礎" icon="sparkles" href="/ja/learn/foundations/introduction-to-ai">
    言語モデルの仕組みと、AIエージェントがモデルとツールを使ってアクションを取る方法を学びます。
  </Card>

  <Card title="Agentと構築する" icon="robot" href="/learn/build-with-agent">
    Agentで作業しながらコンテキストを追加する方法を学びます。
  </Card>

  <Card title="効果的なプロンプティング" icon="comment-dots" href="/learn/effective-prompting">
    有用なコンテキストを含むプロンプトの例を見ます。
  </Card>

  <Card title="replit.md" icon="file-code" href="/references/project-setup/replit-dot-md">
    永続的なプロジェクトコンテキストを提供する方法を学びます。
  </Card>
</CardGroup>
