Embedrエージェント
チャットスレッド、入力欄と添付、承認、アクティビティ、実行中の指示、チェックポイント、通知、音声モード。
Embedrエージェントはプロジェクトの中で作業します。ファイルの読み書き、ファームウェアのビルドと書き込み、Zenerソース・回路図・基板の作業、データシートの読み込み、機構ワークスペースの操作を行います。エージェントとは、プロジェクトのチャットパネルで会話します。
チャットの場所
タイトルバーにレイアウトの切り替えがあります。
| レイアウト | 表示されるもの |
|---|---|
| Agent layout(中央にチャット) | 左にThreadsサイドバー、中央にチャット |
| IDE layout(中央にエディタ) | 中央にエディタ、サイドパネルにチャット。チャットのヘッダーにNew chatと履歴ボタンがあります |
空のチャットでは、Review プロジェクト名、Find risks and gaps、Suggest next stepsの3つの書き出しが表示されます。
チャットスレッド
スレッドはプロジェクトごとにあります。1つのタスクに1つのスレッドを使ってください(「BME280を立ち上げる」「S3ボードへの書き込みを直す」「電源部を配線する」など)。
| 操作 | 方法 |
|---|---|
| スレッドを始める | ThreadsサイドバーまたはチャットヘッダーのNew chat |
| スレッドを切り替える | サイドバーのスレッドをクリックするか、チャットヘッダーの履歴ボタンを使います |
| 名前を変更する | タイトル(サイドバーの行またはチャットヘッダー)をダブルクリックし、入力してEnterを押します。Escで取り消します |
| スレッドを探す | Threadsヘッダーの検索アイコンをクリックし、Filter threads...を使います |
| 削除する | スレッドにカーソルを合わせ、ゴミ箱アイコンをクリックします |
| チャットファイルのパスをコピーする | スレッドにカーソルを合わせ、コピーアイコンをクリックします |
Embedrは最初のメッセージから新しいスレッドに名前を付け、少し後に仮の名前を生成した名前に置き換えます。自分で入力した名前は常に優先されます。
サイドバーには最新の15スレッドが表示されます。残りはN moreをクリックします。行の表示:
- 動くドット状のローダー: Agent is working...
- 緑の点: 最後に見てからAgent finished
- 小さな数字: そのスレッドのキューで待機中のメッセージ
- ドット状のバッジ付きでインデントされた行: 起動元のスレッドの下にあるヘルパースレッド
デスクトップアプリでは、チャットはプロジェクトフォルダの外、~/EmbedrProjects/.embedr/<project-name>/chats/に保存されるため、コードと一緒にコミットされません。ブラウザでは、Webプロジェクトと一緒に保存されます。
入力欄
入力欄のプレースホルダーは「Ask about your project… @ files · paste images」です。
| キー | 操作 |
|---|---|
| Enter | 送信(エージェントの作業中はキューに追加) |
| Shift+Enter | 改行 |
| Shift+Tab | プランモードのオン/オフ |
| Esc | @リストやメニューを閉じます。下書きが消えることはありません |
下書きはスレッドに残るため、ほかのスレッドに移って戻っても失われません。
ファイルとデータシートを指定する
@を入力すると、プロジェクトのファイルとインデックス化されたデータシートの一覧が開きます。続けて入力すると絞り込まれ(最大20件)、矢印キーで移動してEnterまたはTabで選びます。ファイルはチップとして添付され、テキストには@nameが残ります。
添付
クリップアイコン、チャットへのファイルのドロップ、または貼り付けで添付します。タイルをクリックするとプレビューが開き、プレビューには削除ボタンがあります。
| 添付するもの | 処理 |
|---|---|
| 画像(PNG、JPEG、WebP、GIF) | 画像として送信されます。大きな画像は長辺2048 pxに縮小されます |
| BMP、画像として貼り付けたSVG、AVIF、ICO、APNG | 先にPNGまたはJPEGに変換されます |
| HEIC、HEIF、TIFF | 拒否されます: 「HEIC images aren't supported. Export as PNG or JPEG and attach again.」 |
ソースコード、KiCadファイル(.kicad_sch、.kicad_pcb、.kicad_sym、.kicad_modなど)、Zenerの.zen、ガーバーとドリルファイル、SPICEネットリスト、Markdown、JSON、YAML、CSV、ログ、Intel HEX、STEP |
テキストとして読み込まれ、メッセージに含まれます |
| 不明なファイル形式 | 内容がテキストのようであれば受け付けます |
Altiumの.SchDoc、.PcbDoc、.PrjPcb、.OutJob、.SchLib、.PcbLib、.IntLib |
テキストの要約(部品、ネット、層構成、ルール)に変換されます |
| データシートとして処理され、データシートとして添付されます。プロジェクト内でのみ利用できます | |
アーカイブ、実行ファイル、ファームウェアのバイナリ(.bin、.elf、.uf2)、STL、3MF、GLB、Office文書、メディア、フォント |
拒否されます: 「.zip is a binary format, so its contents can't be read as text.」 |
1メッセージあたりの制限:
| 制限 | 値 |
|---|---|
| 添付 | 24(超過したファイルは「Too many attachments」としてスキップされます) |
| 画像 | 8 |
| 画像の合計 | 変換後で約18 MB |
| 変換前の画像1枚 | 40 MB |
| 1ファイルから読み込むテキスト | 256 KB。それより長いファイルは切り詰められ、残りはプロジェクトから読むようエージェントに伝えられます |
| Altiumファイル | 80 MB |
2,500文字以上、または40行以上を貼り付けると、入力欄に入る代わりにPasted textの添付になります。本文に入れたい場合は、開いてInsert as textをクリックします。
入力欄の右にあるリングは、スレッドがモデルのコンテキストをどれだけ使っているかを示します(例: 「120K of 272K tokens · 56% left」)。長い下書きが収まらない場合はツールチップに表示されます。添付を外すか、新しいチャットを始めてください。
選択範囲や出力をチャットに送る
次の場所でテキストを選択し、浮かんで表示されるAdd to Chatボタンをクリックします。
- コードエディタ
- ターミナルタブ
- ビルドのOutputパネル
- シリアルモニター
ビルドが失敗すると、OutputパネルにAsk agent to fixが表示されます。基板、回路図、3Dビューでは、選択した部品にAdd to chatがあります(3Dで選択した部品ではAを押します)。機構ワークスペースでは部品のメモがチップとして追加されます。機構設計を参照してください。
エージェントの設定
モデル選択の横にあるスライダーのボタンで設定メニューが開きます。変更はそのたびにスレッド内でエージェントに伝えられます。
| セクション | オプション | 効果 |
|---|---|---|
| Agent behavior | Auto-flash | ビルドが成功したら、選択中のデバイスに書き込みます。安全なポートがなければポートの選択を求めます |
| Auto-debug | ビルド、書き込み、実行時、シリアル出力に問題が出たら、調べて修正し、チェックを再実行します | |
| Auto-review | コードやハードウェアの変更を終える前に変更をレビューし、残るリスクを指摘します | |
| Interface | Follow agent | エージェントの作業に合わせてタブやパネルを切り替えます(例: コンパイル後のOutput) |
| Terminal approvals(デスクトップ) | Default permissions、Low-risk auto approve、Full access | ターミナルコマンドの承認方法。下記を参照してください |
Full accessがオンのとき、ボタンには警告の盾アイコンと「Full access」のラベルが表示されます。
承認
一部の操作は、実行前に停止して入力欄のエリアで確認を求めます。
| 承認を求めるもの | 補足 |
|---|---|
| ターミナルコマンド(デスクトップ) | Terminal approvalsのモードとSettings → Command Approvalによります |
| エージェントによるあなたのターミナルセッションへの入力 | 常に確認します |
| PCB Auto PlaceとPCB Auto Layout | 常に確認します。有料プランが必要で、ない場合はカードにView plansが表示されます |
| PCB成果物のエクスポート(デスクトップ) | 常に確認します |
カードには、コマンドや操作、リスクの理由(Show Risk Analysisがオンの場合)、次の選択肢が表示されます。
| 選択肢 | 意味 |
|---|---|
| Allow once | いま実行します |
| Always allow | いま実行し、以後このカテゴリを自動承認します。破壊的なコマンドでは表示されません |
| Enable full access | 実行し、以後どのターミナルコマンドでも確認しません |
| Decline | 実行しません。そのことがエージェントに伝えられます |
Confirmをクリックして回答します。ターミナルのモード:
- Default permissions: 読み取り専用、ビルド、バージョン管理のコマンドは確認なしで実行し、それ以外は確認します。
- Low-risk auto approve: ファイルを変更・削除しないコマンドも確認なしで実行します。
- Full access: ターミナルの確認を行いません。SettingsのYOLO Modeと同じです。
表示していないスレッドやプロジェクトから承認依頼が来た場合はポップアップが表示されます。最小化するとタイトルバーのピル表示になります。ブラウザでは、コマンドは確認なしでクラウドのサンドボックスで実行されます(「Cloud sandbox: commands run without approval prompts.」)。PCBの自動化は引き続き確認を求めます。
アクティビティのタイムライン
エージェントのツール呼び出しは、メッセージの間でグループにまとめられます。各グループは折りたたまれ、「Read 3 files, ran 10 commands」のように要約されます。グループを展開すると各呼び出しが表示され、呼び出しを展開すると詳細(完全なコマンド、差分、出力)が表示されます。ツールが生成した画像は、グループの右にサムネイルとして表示され、プレビューで開けます。
実行中は、最新のグループが現在の作業内容(「Searching project files…」「Thinking…」「Compacting context…」「Waiting for you」)とともに光って表示されます。実行時間は最後に一度だけ表示されます。
- 最後の返信の下にWorked for 4m 12s
- 実行中はWorking for…
- 途中で終わった場合はFailed after…またはCancelled after…
回答や承認を待っていた時間は含まれません。
長いスレッドがコンテキストの上限に近づくと、Embedrは以前のターンを自動的に要約します。その箇所には区切り線が表示されます: 「Compacting context...」のあと「Context automatically compacted」。
返信の行には、コピー、Helpful?の評価ボタン(その返信へのフィードバックを送信)、モデルが提供する場合は推論の要約もあります。
エージェントの作業中
入力は続けられます。送信ボタンはQueue messageになり、キューに入ったメッセージは入力欄の上に積み重なります。
| 操作 | 効果 |
|---|---|
| Steer | デスクトップ: メッセージは実行中の作業の次のステップの前に加わり、行にJoins next stepと表示されます。ブラウザ: 現在の実行が停止し、メッセージが次に送信されます |
| 削除(x) | キューのメッセージを取り除きます |
| Send next | 何も実行していないときに表示され、キューの最初のメッセージを送信します |
| 四角い停止ボタン | Cancel Generation |
実行が正常に終わると、キューのメッセージは順番に送信されます。キャンセルやエラーのあとはSend nextを待ちます。
実行がAgent Pausedで止まった場合は、Continueをクリックすると続行します。
エージェントからの質問
あなたにしか決められない判断が必要なとき、エージェントは推測せず、入力欄のエリアで1〜4個の質問をします。選択肢を選ぶか、Something elseを選んで入力するか、You decideを選んでエージェントに既定値を選ばせ、それを前提として記録させます。全体の流れはプランモードを参照してください。
チェックポイントと取り消し
Enable Chat Checkpointsがオン(Settings → General)の場合、Embedrはメッセージを送るたびにその前のプロジェクトのスナップショットを取ります。
- Restore checkpoint and edit message(過去の自分のメッセージにあります): プロジェクトのファイルをその時点に戻し、それ以降をすべて削除し、メッセージを入力欄に戻して編集できるようにします。
- Delete from here(チェックポイントのないメッセージにあります): そのメッセージとそれ以降を会話から削除します。ファイルには触れません。
どちらも確認を求めます。機構ワークスペースでは、Cmd+Zでエージェントの直前のターンを取り消すこともできます。機構設計を参照してください。
通知
Embedrがバックグラウンドにあるときや別のスレッドを見ているとき、実行の完了、失敗、回答や承認が必要になったことを通知します。ホーム画面から初めてエージェントに作業を任せたときやImplement this specをクリックしたとき、入力欄の上にKnow when it's doneの案内が表示され、Turn onを選べます。macOSで通知が表示されない場合は、System Settings → NotificationsでEmbedrを許可してください。ブラウザではメール通知も選べます。
タイトルバーのベルに最近の通知が一覧表示されます。クリックするとそのスレッドが開きます。何を通知するかはSettings → Notificationsで変更します。
音声モード
音声モードは、HobbyとProのデスクトップアプリで使えます。入力欄のマイク(Start voice mode)をクリックします。普通に話してください。オーブが状態を示します: Listening、Thinking…、Working with Embedr Agent…、Speaking、Approval needed in Embedr。音声での返信は、スレッド内にEmbedr Voiceと表示されます。
- 話している最中にオーブをクリックすると、返信を止めます。
- 左のボタンでマイクをミュートし、xで音声モードを閉じます。
- メインウィンドウを最小化すると、浮かんだオーブが最前面に残ります。クリックするとEmbedrに戻ります。
問題が起きたとき
| メッセージ | 対処 |
|---|---|
| Reconnect ChatGPT | Settings → AI AccountsでChatGPTアカウントを再接続してから再試行します |
| OpenCode balance required | OpenCodeアカウントに残高を追加するか、別のモデルを選びます |
| Model Usage Limit / Provider Rate Limit | リセットを待つ、使用量を追加する、またはモデルを切り替えます。モデルを参照してください |
| 「This conversation has become too long. Please start a new chat.」 | 新しいスレッドを始め、必要なファイルや仕様書を指定します |
| Reauthenticate to continue | もう一度サインインします |
依頼の例
目的、制約、確認方法を書いてください。
ファームウェア:
このESP32-S3プロジェクトでは、2秒ごとにI2CでBME280を読み、温度・湿度・気圧を115200ボーで出力したいです。現在のコードを確認し、ライブラリがなければインストールしてビルドしてください。Wi-Fiのコードには触れないでください。
@main.cpp モーターが動き出すとデバイスがリセットします。何かを変更する前に、追加したシリアルログを読んで、ブラウンアウトかウォッチドッグリセットかを教えてください。
ハードウェア:
基板にUSB-C入力と3.3 VのLDOを追加してください。コンデンサの値は取り込んだAP2112Kのデータシートに従い、既存のI2Cのピン配置は維持し、Zenerソースをビルドしてから、ERCの結果を見せてください。
現在の基板を配線し、未配線のネットと残っているDRCエラーを一覧にしてください。
機構:
この基板用に、肉厚2 mm、USB-Cコネクタ用の開口、取り付け穴の位置にM2.5スタンドオフ4本を持つスナップフィットの筐体を設計してください。ビルドできたら断面図を見せてください。
