Busabase × OpenHandsOpenHandsのナレッジベース
OpenHandsはローカル、sandbox、remote Agent Serverでソフトウェア作業を実行できます。Busabaseは実行が何を証明したか、誰がレビューしたか、どの下流フローが結果を信頼できるかを記録します。
現在のOpenHands作業面
1つのエコシステムに複数のruntimeがある。タスク記録には実行面を明記する。
OpenHandsは現在、Agent Canvas、Software Agent SDKとAgent Server、Cloud、Enterprise、Sandbox Serverを分離しています。SDKがconversation、tool、event、workspace、security policyを定義し、クライアントと配備層が利用します。
コントロールセンター
複数backendのconversationとautomationを管理。
実行API
Agent動作と、conversation/workspaceへのREST・WebSocketアクセス。
管理運用
ホスト実行、協働、アクセス制御、利用量、予算。
分離レイヤー
Agent Serverをホストする環境を作成・管理。
イベント履歴と受け入れ結果
永続conversationは何が起きたかを示す。何が事実になったかは決めない。
OpenHands SDKはmessage history、action、observation、tool output、execution state、metrics、workspace context、activated Skillを永続化できます。event logは実行証拠です。業務やリリース状態にはruntime外の責任者と判断が必要です。
時系列の実行証拠
Message、action、observation、状態変更のappend-only履歴
生成成果物
対象環境のファイル、patch、テスト、レポート、コマンド
レビュー済みの運用上の意味
結果、証拠参照、責任者、判断、下流状態
実行台帳
目標、実行境界、証拠、判断を別のフィールドで追跡する。
event stream全体を長文フィールドへ貼りません。永続conversationをリンクし、実行比較、失敗調査、承認済み作業の引き継ぎに必要な事実だけを抽出します。
| フィールド | 意味 |
|---|---|
| run_id | OpenHands conversationまたはautomation runへの安定リンク |
| goal | 実行に求めた成果 |
| workspace_ref | リポジトリ、revision、sandbox、環境 |
| execution_state | queued、running、paused、waiting、finished、error、stuck |
| evidence_refs | Event、ファイル、commit、テストログ、observation |
| proposed_outcome | 結果に対するAgentの短い解釈 |
| decision | accepted、conditional、rejected、rerun、superseded |
| owner | 判断に責任を持つ人 |
| next_action | 受け入れにより解放される下流作業 |
アクション安全性とデータ権威
危険なコマンドの確認と、タスク結果の受け入れは別の境界を守る。
OpenHandsはconfirmation policyとsecurity analysisを分離します。AlwaysConfirm、NeverConfirm、ConfirmRiskyが実行停止を決め、analyzerがactionリスクを分類します。Busabaseはその後、実行結果の解釈を正式記録へ反映してよいか確認します。
SDKの直接execute_tool()呼び出しは通常のAgent loopのanalyzerとconfirmationを迂回します。呼び出し側が独自の防護を実装する必要があります。
証拠で状態を変える
イベントは状態変更を提案できる。delivery logは判断できない。
OpenHandsの状態が変わるとWebhookやcallbackがChange Requestを開けます。delivery logはイベント到着を示すだけです。レビューではevent、workspace成果物、証拠が提案状態を正当化するか確認します。
| Runtime event | 記録提案 | 人の仕事 |
|---|---|---|
| conversation.finished | 最終応答と証拠参照を関連付け | ready_for_reviewを提案 |
| conversation.error | エラーと最後の成功observationを関連付け | blockedを提案 |
| waiting_for_confirmation | 保留actionとリスク文脈を関連付け | 人の判断を割り当て |
| rerun.completed | 前回実行と変更入力を関連付け | 後継結果を提案 |
保守中の作業面へ接続
現在のSkillsとMCP文書を使い、旧runtime設定を持ち込まない。
OpenHandsはAGENTS.md、移植可能なAgent Skills、project/user Skill scope、設定可能なMCP toolsをサポートします。現在の製品構成はAgent CanvasとSoftware Agent SDK/Agent Serverが中心です。CLI/MCP設定はBusabase接続ページを使い、runを所有するbackendとworkspaceを確認します。
自律実行記録の質問
OpenHandsナレッジベースのFAQ
BusabaseはOpenHands conversation persistenceの代わりですか？
いいえ。OpenHands persistenceはconversationを再開・検査するevent historyとexecution stateを保存します。Busabaseは他チームやシステムが信頼するレビュー済み解釈を保存します。
すべてのOpenHands eventを記録にしますか？
いいえ。大半はrun logに残します。runtime外の所有が必要な重要状態変更、例外、証拠、結果だけを記録へ反映します。
Conversationがfinishedなら結果も承認済みですか？
違います。Finishedは実行状態です。受け入れは目標、証拠、テスト、業務影響、責任あるレビュー担当で決まります。
OpenHandsはBusabaseをAgent Skillとして使えますか？
OpenHandsはAgent Skills仕様とproject/user scopeをサポートします。Skillはワークフローを案内し利用可能なtoolを呼べますが、権限自体は付与しません。アクセスは環境とcredentialに従います。
どのOpenHands設定を使うべきですか？
現在のAgent Canvas、SDK/Agent Server、Cloud/Enterprise、Skills/MCP文書を使います。旧V0 config.tomlやtrajectory設定を一般的なV1動作として扱いません。
1つの自律タスクから始める
次のOpenHands実行に明確な受け入れ契約を与える。
実行前にgoal、workspace、証拠フィールド、レビュー担当を定義します。OpenHandsが作業とevent trailを生成し、責任者が再利用可能な状態を決めます。