Hermes Agent Wiki 非公式・日本語wiki

成果物モード

目次

Hermes Agent をメッセージアプリの窓口(Slack、Discord、Telegram、 WhatsApp、Signal など)で動かしているとき、生成したファイルをそのまま チャットへ届けられます。置き場所を写して開いてもらうのではなく、そのアプリの標準の添付として送られます。

グラフはその場で開く画像として、PDF の報告書はダウンロードできるファイルとして、 表計算は .xlsx として届きます。エージェントの側で MEDIA: の印を書いたり、 特別な操作をしたりする必要はありません。ファイルを作って、その絶対パスを 返事の中で触れるだけです。窓口側が文章からその場所を拾い、見えるメッセージからは取り除いて、 ファイルを標準の形で送り出します。

しくみ

3 つの部品が組み合わさっています。

  1. ファイルを作るツールをエージェントが持っている。 matplotlib でグラフを描く

execute_code、Word 文書の docx スキル、表計算の xlsx スキル、 PDF の pdflatex-pdf-report スキル、スライドの powerpoint スキル、画像の image_generate、 音声の text_to_speech などです。

  1. 窓口がエージェントの返事からファイルの場所を探す。 対応する拡張子で終わる

絶対パス(/tmp/...)やホーム起点のパス(~/...)が取り出されます。 コードブロックとインラインコードの中にある場所は 対象外なので、コード例が崩れることはありません。

  1. 窓口が種類ごとに送り分ける。 画像はアプリが対応していればその場に表示され、

動画もその場に表示され、音声は音声メッセージや音声添付として届き、 それ以外はファイル添付として送られます。

対応する拡張子

種類 拡張子 届き方
画像 .png .jpg .jpeg .gif .webp .bmp .tiff .svg その場に表示
動画 .mp4 .mov .avi .mkv .webm .3gp その場に表示(対応するアプリのみ)
音声 .mp3 .m2a .wav .ogg .opus .m4a .flac 音声メッセージ/音声添付
文書 .pdf .docx .doc .odt .rtf .txt .md .epub ファイル送信
データ .xlsx .xls .ods .csv .tsv .json .xml .yaml .yml ファイル送信
地理情報 .kmz .kml .geojson .gpx ファイル送信
プレゼン資料 .pptx .ppt .odp .key ファイル送信
書庫 .zip .tar .gz .tgz .bz2 .xz .7z .rar .apk .ipa ファイル送信
Web .html .htm ファイル送信

.py.log などソースコードの拡張子は、エージェントが手当たり次第に ソースを送ってしまわないよう、あえて外してあります。コードを相手に見せたいときは コードブロックを使ってください。

成果物を作るように促す

エージェントは放っておくと成果物を作りにいきません。作ってよいと分かる必要があります。 促し方は 2 通りです。

その場ごと: 「比較をグラフで送って」「データは CSV で返して」のように はっきり頼むか、メッセージアプリでは成果物の形で返しやすくなるよう 自分でカスタム指示や人格の記述を書いておきます。

プロジェクト単位: エージェントが作業するプロジェクトの AGENTS.mdCLAUDE.md.cursorrules、全体の人格を書く ~/.hermes/SOUL.md、あるいは ~/.hermes/config.yamlagent.personalities に名前を付けた設定として書いておきます(後者は会話ごとに /personality で切り替えられます)。

エージェントがやることは単純です。ファイルを絶対パス (たとえば /tmp/q3-revenue.png)に書き出し、その場所を返事の中で ただの文章として触れる。あとは窓口が引き受けます。コードブロックや バッククォートの中にある場所は対象外なので、コード例が崩れることはありません。

かんばん:成果物は完了の知らせに同乗する

Hermes の複数エージェントによるかんばんの進め方を使っている場合、働き手は kanban_complete を呼ぶときに成果物のファイルを添えられます。

kanban_complete(
    summary="rendered Q3 revenue chart and report",
    artifacts=[
        "/tmp/q3-revenue.png",
        "/tmp/q3-report.pdf",
    ],
)

その仕事を Slack や Telegram などで見守っていた相手に「完了しました」の知らせが届くとき、 窓口はそれぞれの成果物もそのチャットへ標準の添付として一緒に送ります。 人の側は、成果物と要約を同じ場所で受け取れます。

知らせを送る時点でディスク上に見当たらないファイルは、黙って飛ばされます。

MCP でつなげる先を増やす

成果物を届けるしくみとは別に、エージェントは MCP(Model Context Protocol)を通じて ほかのサービスにも手を伸ばせます。MCP には主なツール向けの 有志のサーバーが揃っているので、必要なものを入れてください。

サービス できるようになること
Notion Notion のページやデータベースの読み書き、ワークスペースの検索
GitHub issue、PR、コメント、gh CLI では届かない範囲のリポジトリ検索
Linear チケット、プロジェクト、サイクル
Slack ワークスペース全体の検索、ほかのチャンネルの閲覧
Gmail 受信箱の仕分け、メール送信、ラベルの管理
Salesforce リード、商談、取引先のデータ
Snowflake / BigQuery データウェアハウスへの SQL
Google Drive ファイル検索、中身の取得、共有設定の管理

MCP サーバーは ~/.hermes/config.yamlmcp_servers の節に書いて入れます。設定の全体は MCP 連携 を参照してください。

Slack 上の Perplexity Computer との比較

Perplexity Computer の Slack 連携も、同じ考え方で作られています。 エージェントが成果物(グラフ、PDF、スライド)を作り、 スレッドへ標準の添付として投稿する。Hermes Agent の成果物モードは、 使う人から見て同じ体験を手元で実現します。

  • 生成は利用者自身の venv やサンドボックスの中で行われます(外部の間借り先ではありません)。
  • ファイルは同じ Slack の files.uploadV2 API でチャットへ届きます。
  • つなげる先の広さは、400 個の連携をそろえた提供元の一覧ではなく MCP が担います。実際に使うものだけを入れてください。

OAuth のトークンは利用者の端末の auth.json.env に置かれたままです。預けて保管する場所も、 複数の利用者で分け合う microVM もありません。行き着く先は同じです。