> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ja/resources-context/codebase.md).
# コードベース
本記事では、 **リソースとコンテキスト** タブ内の **コードベース** 機能について説明します。ソースコードを ZIP ファイルにし、アップロードすることでソースコードをワークスペースに登録でき、AI がコードの内容を参照しながら質問への回答やワークフローの実行を行えるようになります。GitHub リポジトリとの連携については、[GitHub連携](/features-ja/resources-context/github-integration.md) を参照してください。
## 前提条件
| 操作 | 必要な権限 |
| --------------- | ---------- |
| ZIP ファイルのアップロード | 全メンバー |
| コードベースの削除 | 管理者 / オーナー |
## ZIP ファイルでアップロードする
コードベースのアップロード画面
1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. アップロードエリアに ZIP ファイルをドラッグ&ドロップするか、エリアをクリックしてファイルを選択します。
4. アップロードの進捗がパーセンテージで表示されます。完了後、自動でインデックス処理が開始されます。
5. ステータスが **{n}件インデックス済み** に変わるとコードベースが利用可能になります。
{% hint style="info" %}
対応形式は ZIP （.zip）のみです。ZIP ファイルは最大 200 MB、解凍後の合計サイズは最大 5 GB、ZIP 内のファイル数は 100,000 件までです。
{% endhint %}
{% hint style="info" %}
ZIP ファイルのアップロードは AI 使用量を消費します。使用制限に達するとアップロードができなくなります。また、ストレージ使用量が上限の 80% に達すると警告が表示され、上限を超えた場合は新規アップロードが無効になります。
{% endhint %}
### 対応するファイル形式
インデックス化の対象となるファイルの拡張子は以下のとおりです。
**コードファイル**: `.ts` / `.tsx` / `.js` / `.jsx` / `.py` / `.go` / `.java` / `.rb` / `.rs` / `.c` / `.h` / `.cpp` / `.hpp` / `.cc` / `.cxx` / `.cs` / `.kt` / `.kts` / `.swift` / `.php` / `.sh` / `.sql`
**設定・ドキュメントファイル**: `.yml` / `.yaml` / `.toml` / `.json` / `.md` / `.txt`
`node_modules/` / `.git/` / `dist/` / `build/` などのディレクトリ、テストファイル・ロックファイルは自動的に除外されます。
### インデックスステータス
| ステータス | 説明 |
| ----------------------- | ----------------------------------------- |
| 準備完了 | 抽出済みの状態 |
| インデックス作成の待機中 | インデックス処理の開始を待っている状態 |
| インデックス作成中 ({処理済み}/{合計}) | ファイルを解析・インデックス化中。処理済みファイル数/合計ファイル数が表示されます |
| {n}件インデックス済み | インデックス処理が完了し、利用可能な状態 |
| インデックス作成失敗 | インデックス処理でエラーが発生した状態 |
| 失敗 | アップロードまたは解凍処理でエラーが発生した状態 |
## コードベースを削除する
ZIP アーカイブとして登録したコードベースを削除します。GitHub リポジトリを使用したコードベースの削除については、[GitHub連携](/features-ja/resources-context/github-integration.md) を参照してください。
1. ワークスペースページで **リソースとコンテキスト** タブを選択します。
2. **コードベース** を選択します。
3. 削除するコードベースの右端にある **メニュー** () をクリックします。
4. **削除** をクリックします。
## トラブルシューティング
### アップロード時のエラー
| エラーメッセージ | 対処方法 |
| ----------------------------------------------- | --------------------------------------------------------------------------------------- |
| .zipファイルをアップロードしてください | ソースコードを .zip 形式で圧縮してからアップロードしてください。 |
| File size exceeds maximum allowed size of 200MB | `node_modules/` や `dist/` などの不要なディレクトリを除外して 200 MB に収まるよう ZIP を再作成してください。 |
| Failed to fetch | ページを再読み込みして再度アップロードしてください。 |
| ストレージ上限を超えました | 組織のストレージ容量が上限に達しています。不要なコードベースを削除してストレージを確保してください。上限の引き上げが必要な場合は組織の管理者 (オーナー) にご相談ください。 |
| 使用制限に達しました。制限を増やすには管理者に連絡してください。 | 組織の AI 使用量が上限に達しているため、組織の管理者 (オーナー) にご相談ください。 |
### 解凍・展開時のエラー
アップロード後にステータスが **インデックス作成失敗** または **失敗** になる場合、以下の原因が考えられます。コードベースを一度削除してから、原因に応じて ZIP を修正のうえ再アップロードしてください。
| 原因 | 対処方法 |
| ---------------------------------------------------- | ----------------------------------------------------- |
| ZIP 内のファイル数が 100,000 件を超えている | テストファイルやキャッシュファイルを除外し、100,000 件以内になるよう ZIP を再作成してください |
| ZIP 内に 200 MB を超える個別ファイルが含まれている | 該当ファイルを除外して ZIP を再作成してください |
| 解凍後の合計サイズが 5 GB を超えている | コードベースを分割するか、不要なファイルを除外して ZIP を再作成してください |
| Windows の ZIP ツールで作成した ZIP にドライブレター（`C:\` など）が含まれている | Unix/Linux 環境または標準的な ZIP ツールで再作成してください |
| ZIP にシンボリックリンクが含まれている | シンボリックリンクを実体ファイルに置き換えてから ZIP を再作成してください |
### インデックス処理のエラー
| 状況 | 原因 | 対処方法 |
| ------------------------------ | ---------------- | ------------------------------------------------------ |
| ステータスが **インデックス作成失敗** のまま変わらない | 埋め込み処理中にエラーが発生した | コードベースを一度削除して再度アップロードしてください。繰り返し発生する場合はサポートにお問い合わせください |
| **インデックス作成の待機中** が長時間続く | 処理キューが混雑している | しばらく待ってから状況を確認してください。解消しない場合はサポートにお問い合わせください |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.genesis.autify.com/features-ja/resources-context/codebase.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.