Hermes Agent
ShanoneのHermes Agent連携では、セルフホストのHermes Agentサーバーを操作する23のツールをエージェントが利用できるようになります——セッション(エージェントとの対話)、ジョブ(スケジュール/トリガー可能な自動化)、実行(個々の実行インスタンス)、そしてスキル/機能の検出まで対応します。はじめに
1
Hermes Agentサーバーをデプロイまたは確認する
Hermes Agentはセルフホスト型のサーバーです(NousResearch/hermes-agentプロジェクト参照)——そのAPI URL(例:
http://localhost:8642や公開デプロイ先のURL)が必要です。2
Shanoneに登録する
ShanoneダッシュボードのIntegrationsを開き、Hermes Agentを選択してサーバーのAPI URLを入力します。APIキーはサーバー側で
API_SERVER_KEYが設定されている場合のみ必要です。3
リクエストを再試行する
保存が完了すると、
hermes_*ツールへのshanone_execute_tool呼び出しが成功するようになります。利用可能なツール
ShanoneはHermes Agent用に23のツールを提供しており、以下のカテゴリに分類されています。ジョブ
ジョブ
hermes_list_jobs, hermes_get_job, hermes_create_job, hermes_update_job, hermes_delete_job, hermes_pause_job, hermes_resume_job, hermes_trigger_job実行(Run)
実行(Run)
hermes_create_run, hermes_get_run, hermes_stop_run, hermes_approve_run — 実行(run)は単一の実行インスタンスで、進行前に承認が必要になる場合がありますセッション
セッション
hermes_list_sessions, hermes_get_session, hermes_create_session, hermes_send_message, hermes_update_session, hermes_delete_session, hermes_fork_sessionスキル & サーバー情報
スキル & サーバー情報
hermes_list_skills, hermes_list_toolsets, hermes_get_capabilities, hermes_health_checkよくある使い方
スケジュール自動化
Hermesのワークフローを定期的に実行するジョブを作成する
人間参加型の実行
承認が必要な実行をトリガーし、提案されたアクションに基づいて承認または拒否する
会話の分岐
元の会話を失わずに別のアプローチを試すためセッションをフォークする
機能の確認
新しいジョブを設計する前に利用可能なスキルとツールセットを確認する
トラブルシューティング
hermes_*のツール呼び出しがすべて即座に失敗する
hermes_*のツール呼び出しがすべて即座に失敗する
まず
hermes_health_checkを実行してください——設定されたapi_urlに到達できない、または間違っている場合、他のすべての呼び出しも同様に失敗します。サーバーが起動していること、URLに余分なパスが付いていないことを確認してください。hermes_trigger_jobで実行は開始するが完了しない
hermes_trigger_jobで実行は開始するが完了しない
hermes_get_runで確認してください——一部の実行はhermes_approve_runを待って一時停止します。人間参加型の承認を前提としたジョブの場合、承認または停止されるまで保留状態が続きます。hermes_create_jobでジョブは受理されるがスケジュール通りにトリガーされない
hermes_create_jobでジョブは受理されるがスケジュール通りにトリガーされない
ジョブが一時停止されていないか確認してください——
hermes_pause_jobはhermes_resume_jobが呼ばれるまでスケジュールトリガーを無効化し、この状態はサーバー再起動後も保持されます。