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

# 新しいセッション：プロジェクト、実行方法、権限、モデル

> 新規チャットページからセッションを開始する方法を説明します。プロジェクト、実行環境（クラウドサーバーまたはあなたのデバイス）、権限とモデルの選択、初回送信前に表示される可能性のある確認について扱います。

**新規チャットページ**は、AIHubMix Cloud で**セッション**を開始する場所です。プロジェクトと実行環境を選び、メッセージボックスに依頼内容を書いて送信します。セッションが作成され、エージェントが作業を開始します。開始済みのセッションで要件を追加する場合は、[Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md) を参照してください。

## 対応環境

| 形態 | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | |
| Web アプリ | 対応 | **Run on your device** も選べます。デバイスの実行許可は、そのデバイス上のアプリでのみ変更できます |
| モバイル Web | 対応 | |

## 入口

* サイドバーの **New chat** ボタン、または `⌘N`。
* `⌥⌘O`：**No project** を選択した状態で新規チャットページを開きます。
* サイドバーのプロジェクト行にカーソルを合わせると表示される **＋**、またはプロジェクトページの **New task in this project**：そのプロジェクトを選択した状態で新規チャットページを開きます。

Windows では `⌘` を `Ctrl` に、`⌥` を `Alt` に置き換えてください（以下同様）。

## 新規チャットページの構成

| エリア | 備考 |
| - | - |
| 挨拶 | **What’s on your mind?** などの短い一文です。ヒントにすぎません |
| タグバー | プロジェクトボタンと実行環境ボタンです。最初のメッセージを送信する前にのみ表示されます |
| メッセージボックス | 左下に権限、右下にモデルと推論レベル、送信があります。[Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md) を参照してください |
| 通知行 | Plus を契約していて、クラウドサーバーが現在稼働していない場合、**No cloud server is running yet… we’ll guide you through setup when you create a project or send a message.** と表示されます |

セッションはプロジェクトの現在の作業ディレクトリで開始します。新規チャットページにはブランチの選択はありません。

## 手順

1. **New chat** をクリックします。プロジェクトのデフォルトは **No project** です。
2. （任意）プロジェクトを選びます。
3. （任意）実行環境として **Cloud server** または **Run on your device** の下のデバイスを選びます。
4. （任意）権限、モデル、推論レベルを調整します。
5. 依頼内容を書き（添付ファイルのみの送信も可能です）、`Enter` で送信します（改行は `Shift+Enter`）。
6. セッションがサイドバーに表示されます。セッションが作成されると自動でセッションページに移動し、エージェントが作業を開始します。

初めて **Full access** で送信するとき、または初めてクラウドサーバー上で送信するときは、先に確認が表示されることがあります。下記「送信前の確認」を参照してください。

## プロジェクトを選ぶ

プロジェクトボタン（`⌥⇧⌘O`）をクリックしてメニューを開きます。プロジェクトの検索、プロジェクトの選択、**New project**、**No project** を選べます。新規チャットページでは、`⌥⌘1`〜`⌥⌘9` でプロジェクト 1〜9 を直接選ぶこともできます。

* 各プロジェクトの下にはソースのテキストが 1 行表示されます（GitHub リポジトリ名、**Local · folder name** など）。セットアップが完了していないプロジェクトには **Setting up · not ready yet** と表示されます。
* 別のコンピューター上のローカルプロジェクトも選択できます。セッションはそのデバイス上で実行されます。そのデバイスがオフラインの場合は **Device offline** と表示されます。
* 新規チャットページは前回選んだプロジェクトを記憶しません。**New chat** をクリックするたびに **No project** に戻ります。

### プロジェクトなし

**No project** のセッションはプロジェクトに紐づきません。一時的な作業ディレクトリで実行され、Q\&A、スクリプトの作成、資料の整理などに向いています。サイドバーの **Chats** グループに表示され、後からプロジェクトに移動できます。[メッセージとセッション操作](https://docs.aihubmix.com/jp/cloud/sessions/messages.md) を参照してください。

## 実行環境を選ぶ

**実行環境**は、エージェントがどのマシン上でファイルを読み書きし、コマンドを実行するかを決めます。エージェント自体は常にクラウドで動作します。

| 実行方法 | 画面上の表示 | 意味 |
| - | - | - |
| **クラウドサーバー** | **Cloud server** | 完全にあなたのクラウドサーバー上で実行され、あなたのコンピューターは関与しません |
| **あなたのデバイス上** | **Run on your device** の下のデバイス | クラウドのエージェントがそのコンピューターをリモートで操作し、その環境とファイルで実行します |

* デフォルトは **Cloud server** です。ローカルプロジェクトは、プロジェクトがあるデバイス上での実行がデフォルトです。
* 選択できないデバイスはグレー表示になり、理由（**Device offline**、**Execution disabled** など）が表示されます。
* 実行デバイスはセッション作成時に決まり、後から変更できません。別のデバイスを使うには、新しいセッションを作成してください。

デフォルトのルール、デバイスを選択できない理由、デバイスの実行許可、実行ログについては、[実行環境](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md) を参照してください。

## 権限を選ぶ

**権限**は、エージェントが操作の前にあなたに確認するかどうかを決めます。メッセージボックス左下の権限ボタン（`Ctrl+Shift+S`）をクリックします。

| オプション | 説明 |
| - | - |
| **Ask for approval** | 環境外での編集やインターネットの利用の前に、常に確認します |
| **Approve for me** | 安全でない可能性があると検出された操作のみ確認します |
| **Full access** | クラウド環境内でインターネットとファイルに制限なくアクセスします |

* 新しいセッションのデフォルトは **Full access** です。新しいセッションは毎回デフォルトから始まり、前回の選択は記憶されません。
* デバイス上で実行する場合、権限はデバイスの権限の上限を超えられず、上限を超えるレベルはグレー表示になります。上限は、そのデバイス上のアプリの **Machines & access** で変更してください。
* 開始済みのセッションでも、いつでも権限を変更できます。修復タスクとアーカイブ済みのセッションは変更できません。
* 承認のリクエストへの対応方法は、[対応が必要](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md) を参照してください。

### フルアクセスを有効にする際の確認

デバイス上で実行していて **Full access** に切り替えると、**Turn on full access?** が表示されます。エージェントがあなたの同意なしにコマンドの実行、インターネットへのアクセス、任意のファイルの作成と変更を行えるようになることが説明され、機密データの消失や漏洩、プロンプトインジェクションなどのリスク（エージェントがこのプロジェクトのすべてのシークレットを読み取れることを含む）が記載されています。**Confirm** をクリックした場合のみ切り替わります。**Cancel** をクリックするか `Esc` を押すと、元の権限のままになります。

## モデルと推論レベルを選ぶ

メッセージボックスの右下には、モデルボタンと推論レベルボタンがあります。新しいセッションでは、アカウントのデフォルトの選択、または前回セッションを作成したときの選択が使われます。詳しくは [Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md) を参照してください。

## 送信前の確認

以下のダイアログは初回のみ表示されます。どのダイアログでも **Cancel** をクリックするとメッセージは送信されず、テキストと添付ファイルはメッセージボックスに残ります。

### デフォルトでフルアクセス（フルアクセスでの初回送信）

**Full access by default** ダイアログでは、エージェントがコマンドの実行、依存関係のインストール、クラウド環境内のファイルの変更、インターネットと接続済みサービスへのアクセス、このプロジェクトのすべてのシークレットの読み取りを行えることが説明されます。また、メッセージボックス左下でいつでも **Ask for approval** または **Approve for me** に切り替えられることも記載されています。**Got it, start the task** をクリックすると送信され、このダイアログは再表示されません。

### クラウドサーバーの管理者権限（クラウドサーバー上での初回送信）

クラウドサーバーの管理者権限が有効になっている場合、初めてクラウドサーバー上でセッションを開始するときに **Turn on admin access on cloud server** が表示され、次の点が示されます。

* エージェントはクラウドサーバー上で管理者権限を持ち、クラウドサーバーに保存された認証情報を読み取れます。
* 承認とブランチの制限は推奨にとどまり、強制されなくなります。
* 無効にしても、すでに行われた変更は元に戻りません。システムファイルを誤って変更した場合、クラウドサーバーの再構築が必要になることがあります。

**Got it, start the task** をクリックすると送信され、以後は確認されません。管理者権限の有効化と無効化については、[クラウドサーバーの管理者権限](https://docs.aihubmix.com/jp/cloud/cloud-host/admin-permission.md) を参照してください。

## ルールと状態

| 状況 | 表示される内容 | できること |
| - | - | - |
| Plus プランがない | 固定の返信 + アップグレードカード | **Upgrade** をクリックして契約します。契約後、メッセージが自動で送信されます。[Plus なしでの送信](https://docs.aihubmix.com/jp/cloud/plus/without-plus.md) を参照してください |
| 契約済みだが、クラウドサーバーの準備がまだできていない | クラウドサーバーのセットアップ / 復元ガイド | 準備ができると、送信が自動で再開されます |
| セッションの作成に失敗 | メッセージに **Not sent: reason** と表示されます | **Retry** をクリックします |
| セッションは作成されたが、添付ファイルのアップロードに失敗 | 添付ファイルはメッセージボックスに残り、**The chat was created, but attachments failed to upload…** と表示されます | 添付ファイルの再試行をクリックしてから送信します |
| 選択したデバイスで実行が許可されていない、またはそのデバイス上でプロジェクトにリンク済みのフォルダーがまだない | そのデバイスのデスクトップアプリにダイアログが表示されます | 案内に従って有効にするか、フォルダーを選びます。[実行環境](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md) を参照してください |

その他のエラーについては、[エラーと復旧](https://docs.aihubmix.com/jp/cloud/sessions/errors-and-recovery.md) を参照してください。

## よくある質問

### 新規チャットページを開くと、プロジェクトが毎回 No project になるのはなぜですか？

新規チャットページは前回選んだプロジェクトを記憶しません。サイドバーのプロジェクト行の **＋** またはプロジェクトページの **New task in this project** を使ってください。プロジェクトが自動で事前選択されます。

### クラウドサーバー上での実行とデバイス上での実行の違いは何ですか？

どちらの場合もエージェントはクラウドで動作します。**Cloud server** では、コマンドとファイルはクラウドサーバー上にあり、コンピューターの電源を切ってもセッションは続きます。デバイスの場合、そのデバイスがオンラインで、実行が許可されている必要があります。

### 自分のコンピューターを選んだのに、Full access がグレー表示になるのはなぜですか？

そのデバイスに低い権限の上限が設定されています。そのデバイス上のアプリで上限を引き上げてください。

### セッション開始後に別のデバイスに切り替えられますか？

できません。別のデバイスを使うには、新しいセッションを作成してください。

## 関連

* [Composer](https://docs.aihubmix.com/jp/cloud/sessions/composer.md)
* [対応が必要](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md)
* [エラーと復旧](https://docs.aihubmix.com/jp/cloud/sessions/errors-and-recovery.md)
* [実行環境](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md)
* [Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md)
* [Plus なしでの送信](https://docs.aihubmix.com/jp/cloud/plus/without-plus.md)
* [クラウドサーバーの管理者権限](https://docs.aihubmix.com/jp/cloud/cloud-host/admin-permission.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.