# あなたのプロジェクト

プロジェクトは、エージェントの設定と状態を保持する Git リポジトリです。

Canonical page: https://beeuni.ai/docs/ja/project

プロジェクトは1つの git リポジトリです。マニフェスト、エージェントの設定、
エージェントが生成する状態を保持します。同期を維持するための独立したデータベースは
ありません。

Beeuni はプロジェクトを2つの方法で管理します。

- **Beeuni 管理リポジトリ** — Beeuni がプライベートリポジトリを作成してホストします。デフォルトです。
- **インポートした GitHub リポジトリ** — 既存のリポジトリに接続します。Beeuni は GitHub API を通じて操作します。

どちらの場合も、プロジェクトには `default_branch` があります。すべての
[セッション](/docs/ja/work/sessions) はそこからブランチを作成します。すべての
[変更リクエスト](/docs/ja/work/change-requests) はそこにマージされます。GitHub リポジトリの各ブランチは、独自のプロジェクトにできます。`main` と `dev` は、その後、
それぞれ独自のセッションと変更リクエストを持つ別々のプロジェクトとして実行できます。

<a id="a-project-is-not-your-codebase"></a>

## プロジェクトはコードベースではありません

プロジェクトには、エージェントへの指示、
[コネクタ](/docs/ja/connect/connectors)、[トリガー](/docs/ja/connect/triggers)、
およびメモリが含まれます。小さく保ってください — Beeuni は各セッションにこれをクローンします。

コードは別の場所にあります。タスクでコードベースが必要な場合、エージェントは
そのリポジトリをクローンして作業し、そこへ変更リクエストを作成します。既存のコードベースに
マニフェストを追加してプロジェクトに変えないでください。代わりに専用のプロジェクトを作成し、
エージェントが作業するリポジトリを指定してください。

<a id="the-manifest"></a>

## マニフェスト

すべてのプロジェクトにはリポジトリのルートにマニフェストがあり、デフォルトでは `beeuni.yaml` です。
プラットフォームは次のトップレベルキーを読み取ります。

| キー | 設定内容 |
|---|---|
| `default_agent` | デフォルトで実行するエージェント |
| `agents` | エージェントごとの権限付与：コネクタ、シークレット、スキル、Beeuni の権限 |
| `sandbox` | サンドボックスのイメージとハードウェア |
| `triggers` | スケジュールおよび webhook による自動化 |
| `connectors` | プロジェクトがアクセスできる外部ツール |
| `env` | プロジェクトが必要とする環境変数名（値はシークレットから取得） |

不明なキーは無視されます。

古いプロジェクトでは、引き続き `beeuni.toml`（`beeuni_version: 1`）が実行される場合があります。Beeuni は両方の形式を読み取ります。
移行方法については、[レガシー TOML](/docs/ja/project/legacy-toml) を参照してください。

<a id="deleting-a-project"></a>

## プロジェクトの削除

設定の **Danger zone** にある **Delete project** を使うか、`beeuni projects rm` でプロジェクトを削除します。
その時点から、プロジェクトに代わって何かが実行されることはありません。

| 入口 | 削除後 |
|---|---|
| LLM ゲートウェイキー（`kgw_…`） | `401` で拒否されます。 |
| 公開共有リンク | `410` と回答します。 |
| アプリ | 配信されません。 |
| 新しいセッション | `404`、`code: "project_archived"` で拒否されます。 |
| Slack と Teams | 「This Beeuni workspace was deleted…」と返信し、何も開始しません。 |
| メール受信トレイ | スレッドの最初のメールに1回だけ、「This address is not accepting email right now. No one will answer this message.」と返信します。そのスレッド内で30日以内に届く次の返信には何も返さず、送信者認証に失敗したメールにも返信しません。 |
| 既存のセッション | チャットスレッド、トリガー、または削除前にキューに入れられたプロンプトからの新しいメッセージを受け取りません。 |

<a id="in-this-section"></a>

## このセクションの内容

- [マニフェスト](/docs/ja/project/manifest): beeuni.yaml の完全なリファレンス。
- [エージェント](/docs/ja/project/agents): スコープ付きツールを持つ Markdown ペルソナ。
- [モデル](/docs/ja/project/models): セッションが使用するモデルと、支払いを行う人。
- [シークレット](/docs/ja/project/secrets): サンドボックスに注入される暗号化された値。
- [レガシー TOML](/docs/ja/project/legacy-toml): beeuni.toml からの移行。