PerchAI
Perchの使い方

バックグラウンドタスク

長いコマンドや任せたエージェントは、あなたがチャットを続けているあいだバックグラウンドで走り、そのどれかが終わるとPerchが自分で作業を引き継げます。

数分かかる作業はあります。テストスイート、ビルド、長いインストール、できれば見ていたくない処理。Perchはそれを始め、手を離し、終わったころに戻ってこられます。会話を待たせたままコマンドのなかに座り込む必要はありません。

バックグラウンドでは二つの別々のものが走ります。区別しておく価値があります。

バックグラウンドコマンド

バックグラウンドコマンドとは、Perchがあなたのコンピューターで起動し、待たないプログラムのことです。ターンはそのまま進み、コマンドはターンが終わったあとも走り続けます。

Perchは五つのツールでこれを扱います。

ツール何をするか
run_in_backgroundコマンドを切り離したジョブとして起動し、タスクidをすぐに返します。
list_background_tasksタスクとその状態を一覧にします。
check_background_taskブロックせずに最新の出力を読みます。
wait_for_background_task終わるまでブロックします。
kill_background_task停止します。

ハーネスが保証すること。

  • 記録は再起動をまたいで残ります。 タスクはディスクに保存されるので、CLIを終了してもアプリを閉じても見失いません。Perchが戻ったときにプロセスが消えているタスクは、黙って実行中とはせず、不明として報告されます。
  • 出力はファイルに取られます。 Perchは上限つきで出力をまとめて保持し、タスクが上限を超えて書いた場合は先頭と末尾を残します。ツールの結果には、ログ全体ではなく短いプレビューが出ます。
  • 同時に走れる数には上限があります。 一台のマシンで一緒に走るバックグラウンドタスクの数は限られています。上限を超えると、どれかが終わるか止められるまで、新しいタスクは断られます。
  • 一時間。 一時間走り続けたバックグラウンドタスクは、監視役が止めます。

言葉で頼んでかまいません。「テストスイートはバックグラウンドで回して、作業を続けて」で十分です。

終わったタスクにPerchが戻ってくる

役に立つのは、バックグラウンドタスクが終わったときに起きることです。Perchは自分でターンを始めて結果を読み、作業を引き継げます。つまり作業を前に進めるのはビルドが終わったことであって、あなたがそれに気づいて「で、次は?」と言うことではありません。

これはガードレールの内側でしか起きません。

  • Auto ReviewとTake the Wheelのときだけ。 Defaultでは、Perchが自分からターンを始めることはありません。Defaultの趣旨は、あなたがその場で一手ずつ承認することだからです。
  • 一瞬で終わるコマンドでは起きません。 数秒かからずに終わったコマンドは何も起こしません。そうでなければ、短いコマンドが高くつくループに変わってしまいます。
  • チャットごとの上限があります。 ひとつのチャットのなかで自分から始めるターンには上限があるので、自分を再起動し続けるタスクが延々と回ることはありません。

これらのターンには履歴上でラベルがつくので、あなたではなくPerchが始めたものだと必ず分かります。

バックグラウンドエージェント

バックグラウンドエージェントは、ひとつのコマンドではなく、作業まるごとを補助役に渡すものです。/delegate <task>、または/bgで、範囲の決まった作業を自分で動くエージェントに渡します。結果は終わったときに同じチャットへ届きます。

/delegate summarize every PDF in ./contracts and list the renewal dates

作業がそれだけで完結していて、見ているより自分の作業を続けたいときに使ってください。途中であなたの入力が必要な作業や、方向を調整したい作業は、メインのセッションに置いたままにします。

CLIでは、/agentsがこのチャットのエージェントを一覧にし、/agents <id>がひとつのエージェントの手順と報告を出力し、/agents stop <id>がそれを停止します。

エージェントにもバックグラウンドコマンドと同じように枠があります。独自のステップ上限、実時間で30分、そして出力のない10分は停滞と数えられます。どの結果にも、上限に達した場合も含め、エージェントが止まった理由が書かれます。/delegateには開いたままのセッションが要るので、一回きりのperch runでは使えません。

Perchがターンのなかで立てる補助役や、サブセッションについてはサブエージェントを参照してください。ひとつの作業にあたるチームまるごとについてはFlockを参照してください。