Parcha-ai/agentrun

解決する課題

AgentRunは、信頼性が高く、検査可能で、復旧可能なエージェントワークフローを構築するという課題に取り組みます。構造化されたハーネスがない場合、エージェントのステップはアドホックになりがちで、特に外部ツールを呼び出したり意思決定を行ったりする際に監査が困難になります。AgentRunを使用すると、ステップをワークフロードキュメントとして定義し、Jevの型付き意思決定で進行を制御し、ワークフローを永続的に実行して、検査、再実行、復旧を行うことができます。

仕組み

ワークフローをJSONで記述するか、Zodコントラクトを備えたTypeScriptビルダーを使用します。各ワークフローは、入力と出力のスキーマ、call、judge、agentといったステップ、さらにしきい値やレビューパスを定義します。インタープリターがステップを実行し、ユーザーはアダプターを提供します。ツールには runEffect、エージェントには runNode、意思決定には createJevRunner を runJudge として使用します。ワークフローは他のワークフローを呼び出したり、並列で作業をマッピングしたり、境界付きループを実行したりできます。AgentRunには、ハーネスを拡張するパッケージも同梱されています。ドキュメント、画像、動画を読み取る pi-vision、エージェントに独自のブラウザを与える pi-browser、異なるマシンでステップを実行する pi-transport などがあります。すべては永続性のために pi-durable 上で実行され、APIキー不要のスクリプト化されたレスポンスによるデモも利用可能です。

対象ユーザー

Pi（バージョン1.0.4から1.4未満）上でエージェントを構築しており、構造化され、検査可能で、復旧可能なワークフローを必要とする開発者向けです。また、独自のツール、モデル、意思決定ロジックを組み込みつつ、視覚、ブラウザ制御、マシン間トランスポート実行などの機能をすぐに利用したいチームにも適しています。

ハイライト

• 型付きスキーマと状態パスの実行時検証を備えたワークフロー DSL
• 信頼度しきい値とレビューエスカレーションパスを備えた Jev 型付き意思決定
• pi-durable による永続的な実行（各ターンとツール呼び出しをストレージにコミット）
• ワークフローの構築、検査、実行のための /agentrun コマンドを備えた Pi 拡張
• pi-vision：ドキュメント、画像、動画に関する質問に証拠付きで回答
• pi-browser：エージェントが独自のブラウザを取得。ユーザーが操作を代行して戻すことも可能。ページは証拠として保存
• pi-transport：ローカルマシン、Docker、Daytona、または Modal 上でステップを実行し、単一の Box インターフェースで管理
• pi-agent-learn：独自の git リポジトリで学習し、メモをコミットとして整理するエージェント