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

# Composer：添付ファイル、スクリーンショット、スラッシュコマンド、実行中のメッセージ追加

> Composer の使い方を説明します。添付ファイルの追加と利用上限、スクリーンショットの撮影、スラッシュコマンド、セッション実行中のキューと割り込み、ターンの停止、メッセージボックス上のエラーエリアを扱います。

**Composer** は、エージェントにタスクを渡し、要件を追加する場所です。新規チャットページとセッションページは同じ Composer を使います。新規チャットページの Composer 上にあるプロジェクトと実行環境の選択については、[新しいセッション](https://docs.aihubmix.com/jp/cloud/sessions/new-session.md) を参照してください。

## 対応環境

| 形態 | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | このコンピューター上で実行するセッションでは、ファイルはローカル参照として追加されます |
| Web アプリ | 対応 | デバイス上で実行するセッションでは画像のみ追加でき、ファイルは追加できません |
| モバイル Web | 対応 | ブラウザが画面共有に対応していない場合、**Take a screenshot** はグレー表示になります |

## Composer の構成

| 位置 | コントロール | 備考 |
| - | - | - |
| メッセージボックスの上 | エラーエリア、メッセージボックス上のリクエスト、キュー内のメッセージ | 下記と [対応が必要](https://docs.aihubmix.com/jp/cloud/sessions/user-intervention.md) を参照してください |
| 左下 | ファイルや画像を追加する **+** | `⌘U`（Windows は `Ctrl+U`） |
| 左下 | 権限 | [新しいセッション](https://docs.aihubmix.com/jp/cloud/sessions/new-session.md) を参照してください |
| 右下 | モデル、推論レベル | [Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md) を参照してください |
| 右下 | コンテキスト使用量のリング | セッションページでのみ表示されます。カーソルを合わせると使用済みの割合が表示されます。利用上限に近づくと、コンテキストは自動で圧縮されます |
| 右下 | 音声入力 | まだ使えません。**Dictation: coming soon** と表示されます |
| 右下 | **Queue / Steer** の切り替え | ターンの実行中、メッセージボックスに内容がある場合に表示されます。下記を参照してください |
| 右下 | 送信 / このターンを停止 | ターンの実行中にメッセージボックスが空の場合は **Stop this turn** になります |

キー操作：

* `Enter` で送信、`Shift+Enter` で改行します。
* ターンの実行中は、`Esc` を押すと現在のタスクを停止します。
* メッセージボックスが空のときに `↑` を押すと、最後のメッセージを編集できます（現在のエージェントが対応している場合）。[メッセージとセッション操作](https://docs.aihubmix.com/jp/cloud/sessions/messages.md) を参照してください。

## 添付ファイル

### 添付ファイルを追加する

* **+** をクリックし、**Upload files or images** または **Take a screenshot** を選びます。
* ファイルをメッセージボックスにドラッグするか、スクリーンショットやファイルを直接貼り付けます。

テキストなしで添付ファイルだけを送信できます。カーソルがメッセージボックスの先頭にあるとき、`Backspace` を 2 回押すと最後の添付ファイルが削除されます。

### 利用上限

| 項目 | 利用上限 | 超えた場合のメッセージ |
| - | - | - |
| 1 メッセージあたりの添付ファイル数 | 10 | **“file name” not added: up to 10 attachments at a time** |
| 画像 1 枚（PNG、JPEG、WebP、GIF） | 5 MB | **file name exceeds 5 MB. Choose a smaller file.** |
| その他のファイル 1 つ（形式不問） | 25 MB | **file name exceeds 25 MB. Choose a smaller file.** |
| 1 メッセージあたりの添付ファイル合計サイズ | 100 MB | **“file name” not added: attachments can total up to 100 MB** |
| 空のファイル | 追加不可 | **“file name” is empty** |

利用上限を超えたファイルは追加されず、それ以外は通常どおり追加されます。HEIC、HEIF、TIFF 形式の画像は自動で JPEG に変換されます。

### 画像とファイルを追加できるかどうか

追加できない場合、**+** メニューの該当項目がグレー表示になり、理由が表示されます。

| 状況 | メッセージ |
| - | - |
| 現在のエージェントが画像に対応していない | **Agent name doesn’t support image attachments yet** |
| クラウドサーバーの準備がまだできていない、またはアップグレードが必要 | **Images can be added once your cloud server is ready**、**Your cloud server needs an upgrade to send files** など |
| Web アプリで、デバイス上で実行するセッション | ファイルがグレー表示になります：**For tasks running on your computer, add files in the desktop app**。画像は通常どおり使えます |

### 添付ファイルの状態

アップロード中、変換中、アップロード失敗の添付ファイルが 1 つでもある間は送信ボタンが使えず、**Send when attachments are ready** と表示されます。

| 状態 | 表示される内容 | できること |
| - | - | - |
| アップロード中 | **Uploading N%** と進捗バー | 待つか、× をクリックして削除します |
| アップロード失敗 | **Upload incomplete** と理由 | 再試行ボタンをクリックするか、削除します |
| 変換中 | **Converting to JPEG** | 待ちます |
| 変換できない | **This browser cannot convert this image. Use JPEG or PNG.** | 削除し、代わりに JPEG / PNG を使います |
| ローカル参照 | **Local reference** | そのまま送信します |

### ローカル参照（デスクトップアプリ）

セッションが**このコンピューター**上で実行される場合、デスクトップアプリで追加したファイルは **Local reference** としてエージェントに渡されます。アップロードされず、100 MB の合計にも含まれません。プロジェクトフォルダー外のファイルは、まずプロジェクトフォルダーにコピーされます（**Copying to an allowed folder** と表示されます）。参照できない場合は、添付ファイルに理由が表示されます。画像は通常どおりアップロードされます。

### スクリーンショットを撮る

**+** メニューの **Take a screenshot** で撮影した画像は、そのまま送信待ちの添付ファイルになります。

| 形態 | 方法 |
| - | - |
| デスクトップアプリ（macOS） | システムの範囲選択を使います。Space キーでウィンドウのキャプチャに切り替え、`Esc` でキャンセルします。初めて別のアプリのウィンドウをキャプチャするとき、システムが画面収録の権限を求めます |
| デスクトップアプリ（Windows） | アプリがある画面をキャプチャします |
| Web アプリ | ブラウザの画面共有の選択画面でビューを選ぶと、1 フレームがキャプチャされます |

キャプチャに失敗すると **Couldn’t take the screenshot. Try again** と表示されます。

### 送信済みメッセージの添付ファイル

画像をクリックすると拡大表示され、ファイルをクリックするとダウンロードできます。ローカル参照のファイルはファイル名のみ表示され、ダウンロードできません。

## スラッシュコマンド

メッセージボックスの先頭で `/` を入力するとコマンド一覧が開き、続けて入力すると絞り込めます。コマンドは現在のセッションのプロジェクト、エージェント、実行環境に応じて、**Source device · Device only**、**Cloud shared**、**Project**、**Built-in** のグループで表示されます。

* `↑` `↓` で選択し、`Enter` または `Tab` で挿入、`Esc` で閉じます。
* コマンドを選ぶとメッセージボックスに挿入されるだけで、直接送信はされません。
* 使えないコマンドはグレー表示になり、理由が表示されます。最も多いのは **Choose the source device to use this command** です（コマンドが特定のデバイスにのみインストールされており、セッションがそのデバイス上で実行されていない）。

プラグインと Skills の追加と管理については、[プラグイン、MCP、Skills](https://docs.aihubmix.com/jp/cloud/integrations/plugins-mcp-skills.md) を参照してください。

## 実行中のメッセージ追加：キューと割り込み

エージェントが作業している間も、書き続けることができます。送信方法は 2 つあります（セッションがアイドル状態のときは、メッセージは直接送信されます）。

| 方法 | 意味 |
| - | - |
| **Queue** | メッセージボックス上のキューエリアで待機し、このターンの終了後に順番に送信されます。それぞれが独自のターンを開始します |
| **Steer** | 現在のターンにすぐ差し込まれ、エージェントはターン内でそれに対応します |

### 選び方

* デフォルトの方法は **Settings › General** で設定します。下記「デフォルトの方法の設定」を参照してください。
* デフォルトがキューの場合、送信ボタンの横に **Queue | Steer** の切り替えが表示され、このメッセージ 1 件だけを割り込みに切り替えられます。
* `⌘Enter`（Windows は `Ctrl+Enter`）：このメッセージをデフォルトと逆の方法で送信します。

### エージェントが割り込みに対応していない場合

現在、割り込みに対応しているのは Claude Code と Codex のみです。その他のエージェントでは **Steer** がグレー表示になり、すべてのメッセージがキューとして送信されます。

### キューエリア

キュー内のメッセージはメッセージボックスの上に 1 行ずつ表示されます。セッションタイマーによってキューに入ったメッセージには **⏰ Timer** ラベルが付きます。ページを更新しても、別のデバイスで開いても、同じキューが表示されます。

| 操作 | 効果 |
| - | - |
| 行の先頭のドラッグハンドルをドラッグ | メッセージを並べ替えます |
| **Steer** | このメッセージを現在のターンにすぐ差し込みます |
| 削除 | この未送信メッセージを取り消します |
| **…** › **Edit message** | その場で編集し、**Save** します |
| **…** › **Open in side chat** | このテキストをサイドチャットの下書きに移し、キューから削除します（添付ファイルがある場合は使えません） |
| **…** › **Turn off queueing** | デフォルトの方法を割り込みに変更します。キュー内のメッセージは保持されます |

### ターンを停止した後

* ここで **Stop this turn** をクリックした場合：キュー内のメッセージは元の順番で送信され続けます。
* 別の場所でターンが停止された場合（たとえば別のデバイス）：キューは一時停止し、キューエリアに **Queue paused** と **Send all** が表示されます。1 件ずつ **Send** するか削除することもできます。

## デフォルトの方法の設定

**Settings › General** の **Chat** グループにある **Messages sent mid-turn**：**Queue**（デフォルト）または **Steer**。この設定はアカウントに保存され、デスクトップアプリと Web アプリで共有されます。

## このターンを停止

ターンの実行中にメッセージボックスが空の場合、送信ボタンは **Stop this turn** になります。クリックするか `Esc` を押すと停止します。停止後の動作については、[エラーと復旧](https://docs.aihubmix.com/jp/cloud/sessions/errors-and-recovery.md) を参照してください。

## メッセージボックス上のエラーエリア

現在のセッションに関するエラー（送信、アップロード、ネットワーク接続、プレビュー、利用できないソースなど）は、すべてメッセージボックスのすぐ上に表示されます。各カードには説明と 1 つのメインアクション（**Retry** や **Sign in** など）があります。各種エラーと対処方法については、[エラーと復旧](https://docs.aihubmix.com/jp/cloud/sessions/errors-and-recovery.md) を参照してください。

## よくある質問

### 添付ファイルに Upload incomplete と表示され続ける場合は？

添付ファイルの再試行ボタンをクリックして再アップロードしてください。何度も失敗する場合は、ネットワークを確認するか、削除して再度追加してください。

### 送信ボタンがグレー表示になるのはなぜですか？

通常は、添付ファイルがまだアップロード中または変換中であるか、アップロードに失敗しています。完了を待つか、失敗した添付ファイルを再試行するか削除してください。

### 停止をクリックすると、キュー内のメッセージはどうなりますか？

ここで停止をクリックした場合、キュー内のメッセージは順番に送信され続けます。別の場所でターンが停止された場合はキューが一時停止し、**Send all** または各メッセージの **Send** をクリックする必要があります。

### デフォルトを割り込みにしたいのに、メッセージがキューに入ったのはなぜですか？

現在のエージェントが割り込みに対応していない場合、メッセージは自動でキューとして処理されます。Claude Code と Codex は割り込みに対応しています。

### スラッシュコマンドがグレー表示になるのはなぜですか？

コマンドの下にある理由を確認してください。多くの場合、そのコマンドは特定のデバイスにのみインストールされており、現在のセッションはそのデバイス上で実行されていません。

## 関連

* [新しいセッション](https://docs.aihubmix.com/jp/cloud/sessions/new-session.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/sessions/messages.md)
* [Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md)
* [実行環境](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md)


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