Skip to main content

​
OpenHands

ShanoneのOpenHands連携は、OpenHandsのコーディングエージェントの会話を操作するための8個のツールをエージェントに提供します。Shanoneのワークフローを離れずに、自律的なコーディングセッションを作成・メッセージ送信・監視できます。

​
はじめに

1

OpenHands APIキーを作成する

OpenHands Cloudの設定画面からキーを発行します。
2

Shanoneにキーを追加する

Shanoneダッシュボードの連携でOpenHandsを選択し、APIキーを貼り付けます。
3

リクエストを再実行する

保存が完了すると、openhands_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはOpenHands向けに8個のツールを、以下のカテゴリに整理して提供しています。
openhands_list_conversations, openhands_get_conversation, openhands_create_conversation, openhands_start_conversation, openhands_stop_conversation, openhands_delete_conversation
openhands_send_message, openhands_get_conversation_events

​
よくあるユースケース

コーディング作業の委任

OpenHandsの会話を作成し、バグや機能要件を伝えて自律的に作業させる

進捗の監視

openhands_get_conversation_eventsをポーリングし、エージェントがこれまでに行った作業を要約する

複数エージェントへの割り振り

独立したタスクごとに複数の会話を開始し、一箇所からまとめて確認する

セッションの整理

古い会話を一覧表示し、完了・停滞したものを停止または削除する

​
トラブルシューティング

会話の作成と開始は別のステップです。作成後にopenhands_start_conversationを呼び出してください。ツールスキーマを確認し、開始フラグを直接指定できるか確認するのも有効です。
メッセージはアクティブな会話にのみ送信できます。まずopenhands_get_conversationで状態を確認し、停止していればopenhands_start_conversationで再開してください。
長時間実行された会話にはツール呼び出し、ファイル編集、ターミナル出力など多数のイベントが蓄積します。毎回全履歴を取得するのではなく、差分的にイベントを取得してください。