Q: なぜ自律型エージェントは進捗更新テキストを投稿した後、タスクの途中で停止するのですか？

これは既知のバグ（v0.13.6）です：agent-runtime の `runLoop` は、ツール呼び出し数がゼロのアシスタントメッセージをすべて最終回答として扱い、`agent_end` を発行します。モデルがシステムプロンプトの指示に従って次のツールバッチの前に短い進捗文を書いても、そのテキストを `finish_reason: "stop"` 付きで、バンドルされた `tool_call` なしでストリーミングした場合、ループは `toolCalls.length === 0` を検出し、実行を早期に停止します。回避策：フォローアッププロンプト（例："continue"）を手動で送信してタスクを再開してください。適切な修正方法（いずれかを選択）：1) `runLoop` にパッチを適用し、自律モードにおいて、テキストを含むがツール呼び出しも明示的なタスク完了マーカーも含まないアシスタントメッセージが、終了する代わりに1回の自動継続/ナッジをトリガーするようにします（sidecar.js の既存の `pendingSilentTurnRerun`/`SILENT_TURN_NUDGE` リカバリと同様）。2) コラボレーション用システムプロンプトを修正し、次の要件を追加します：「常にツール呼び出しをテキスト更新と同じメッセージ内で発行すること。対応するツール呼び出しを同じターンで伴わずにアクションを告知してはならない。そうしなければ実行は終了します。」

Question 1

親メニューで backdrop-filter (blur) を使用しているとき、position: fixed のサブメニューの位置がずれるのはなぜですか？

Accepted Answer

根本原因: `backdrop-filter`（`none` 以外）を持つ要素は、そのすべての `position: fixed` 子孫要素の包含ブロックとなるため、サブメニューがビューポートではなくメニューを基準に配置され、フライアウトの位置ずれ、水平スクロールバー、オーバーフローによる空白領域が発生します。修正: サブメニューをReact Portal経由で `document.body` にレンダリングし、メニューのボックスツリーから脱出させることで、`fixed` が再びビューポートにアンカーされるようにします: ```tsx {openSubmenuItem ? createPortal(

, document.body, ) : null} ``` サブメニューがルートメニューのDOM子要素ではなくなるため、2つの追加調整が必要です: (1) ルートメニューの `onPointerLeave` では、ポータル化されたサブメニュー内にある `relatedTarget` を引き続きメニュー内にあるものとして扱います。そうしないと、マウスがサブメニューに移動したときにサブメニューが閉じてしまいます。(2) サブメニューパネル自体に `onPointerLeave` を追加し、ポインターが両方から離れたときに閉じるようにします。キーボードナビゲーションに変更は不要です。ReactイベントはReactツリー上をバブルするため、ルートメニューの `onKeyDown` と `closest('[role="menu"]')` は引き続き機能します。また、ルートメニューのリサイズ/スクロール時にサブメニューの位置を再設定し、トリガー行に追従させます。なお、祖先要素の `transform` や `zoom` でも同様の問題が発生しますが、Portalによる修正はこれらすべてをカバーします。

Question 2

Windows の開発チェックアウト環境で vitest を実行した際に発生する 'EPERM: operation not permitted, symlink' エラーとパスアサーションテストの失敗を修正する方法

Accepted Answer

これらはテストフィクスチャのバグ（製品のバグではありません）で、PR #1803 で修正され、コミット d1df8bba0 として main にマージされました。最新の main（0.21.0-beta.4 以降）をプルして、次を再実行してください: `cd packages/host-runtime && pnpm exec vitest run src/launch-resolver.test.ts` および `cd packages/agent-runtime && pnpm exec vitest run src/native-pi-session.test.ts -t sessionDir`。修正内容: (1) launch-resolver のテストは POSIX パス `/data/scratch/s1` をハードコードしなくなり、ホストプラットフォームの `join()` で期待されるパスを構築するようになり、Windows の `\data\scratch\s1` に一致するようになりました。(2) sessionDir のシンボリックリンクフィクスチャは `EPERM` をキャッチして適切にデグレード/スキップするようになり、既存の `createSymlinkOrSkip` の規約に従いつつ、シンボリックリンクが機能する環境では完全なシンボリックリンクのカバレッジを維持します。更新できない場合の回避策: Windows の開発者モード（設定 → プライバシーとセキュリティ → 開発者向け）を有効にしてファイルシンボリックリンクの権限を付与するか、WSL/Linux 環境でテストスイートを実行してください。

Question 3

PI-Desktopでセッションを切り替えた後、保存されていないAskToolのチェックボックスの選択が消えるのはなぜですか？

Accepted Answer

PI-Desktop 0.20.1 の既知のバグ(v0.21.0-beta.4 でも依然として存在)。AskTool カードは、回答の下書きを `AskToolCard.tsx` 内のコンポーネントローカルな `useState` にのみ保持しています。セッションを切り替えるとカードがアンマウントされ(`pendingAsk` が `activeSessionId` でフィルタリングされるため)、チェックしたオプションがすべてリセットされ、カードは質問 1 に戻ります。保留中の ask 自体はストアに残りますが、下書きはどこにも保存されていないため、復元できるものはありません。回避策:セッションを切り替える前に AskTool カードを送信してください。切り替えた後に失われた選択を復元する方法はありません。恒久修正(ソースからビルドする開発者向け):下書きをコンポーネントの状態から切り離し、`requestId` ごとのキャッシュに移します。たとえば、モジュールスコープの `Map`、または ask キューの隣にある `apps/desktop/src/lib/pending-asks.ts` 内の `AskDrafts = Record` スライスです。マウント時にキャッシュされた下書きから `useState` を初期化し、`[drafts, index, request.requestId]` に対する `useEffect` で書き戻し、カードが解決したとき(`ASKTOOL_NOT_FOUND` パスを含む)にエントリを削除して、古い下書きが残らないようにします。

Question 4

なぜターンが終了すると、アクティビティグループが自動的に折りたたまれてツール出力が非表示になるのですか？

Accepted Answer

根本原因: `apps/desktop/src/features/chat/transcript/ActivityGroup.tsx` で、グループの開閉状態が `live`(`isActive || topologyLive`)にバインドされており、ターンが終了した瞬間に `false` に切り替わります。`useAutomaticDisclosure` は `open = choice?.open ?? automaticOpen` として解決するため、ユーザーが一度もクリックしていないグループはすべて自動的に折りたたまれます(複数ツールのグループのみ。単一アイテムのグループは `visibleItems.length <= 1` が true のままなので折りたたまれません)。修正: グループフレームを `live` から切り離します — disclosure 呼び出しを `useAutomaticDisclosure(hasSubagentTopology ? true : visibleItems.length <= AUTOMATIC_OPEN_MAX_ITEMS, revealRequest, disclosureKey(...))` に置き換えます。内部のツール行は引き続き折りたたまれた状態で開始し(`ToolRow` は `useAutomaticDisclosure(false, …)` を使用)、`DisclosureCollapseRail` によりユーザーは手動で折りたたむこともできます。より一般的な修正としては、単一のブール値を `defaultOpen`(インタラクション前の初期状態)と `collapseWhenIdle`(アイドル時に自動折りたたみするかどうか)に分割する方法があります。エンドユーザー向けの回避策: 折りたたまれたグループ行をクリックすると、ツール出力を再展開できます。

Question 5

なぜ自律型エージェントは進捗更新テキストを投稿した後、タスクの途中で停止するのですか？

Accepted Answer

これは既知のバグ（v0.13.6）です：agent-runtime の `runLoop` は、ツール呼び出し数がゼロのアシスタントメッセージをすべて最終回答として扱い、`agent_end` を発行します。モデルがシステムプロンプトの指示に従って次のツールバッチの前に短い進捗文を書いても、そのテキストを `finish_reason: "stop"` 付きで、バンドルされた `tool_call` なしでストリーミングした場合、ループは `toolCalls.length === 0` を検出し、実行を早期に停止します。回避策：フォローアッププロンプト（例："continue"）を手動で送信してタスクを再開してください。適切な修正方法（いずれかを選択）：1) `runLoop` にパッチを適用し、自律モードにおいて、テキストを含むがツール呼び出しも明示的なタスク完了マーカーも含まないアシスタントメッセージが、終了する代わりに1回の自動継続/ナッジをトリガーするようにします（sidecar.js の既存の `pendingSilentTurnRerun`/`SILENT_TURN_NUDGE` リカバリと同様）。2) コラボレーション用システムプロンプトを修正し、次の要件を追加します：「常にツール呼び出しをテキスト更新と同じメッセージ内で発行すること。対応するツール呼び出しを同じターンで伴わずにアクションを告知してはならない。そうしなければ実行は終了します。」

PI-Desktop

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト