钉钉 — 中国職場向けAI | Easy Understand Hermes Agent

上海のオフィスを想像してみてください。ウォータークーラーでの雑談が、明るい青色のアプリアイコンの中で繰り広げられています。それがDingTalk（钉钉）です。Slackの要素もあれば、Trelloの要素もあり、人事ポータルの側面も持つ、数億人にとっての「職場そのもの」と言えるアプリです。さて、そのアプリの中に、あなたのAIエージェント「Hermes」が静かに住んでいると想像してみてください。チャットスレッドから離れることなく、質問に答え、タスクを振り分け、フォローアップを送信するのです。これは、Hermes AgentにおけるDingTalk統合が約束する世界です。

AIエージェントにとってDingTalkが重要な理由

ほとんどのAIエージェントのチュートリアルは、英語圏・西洋のツールを前提としています。しかし中国では、DingTalkがビジネスコミュニケーションのデフォルトOSです。深圳のチームや成都の工場のためにオープンソースのエージェントを構築するなら、ネイティブな橋渡しが必要です。Hermes Agentはまさにそれを提供します。設定ファイルで動くクリーンな統合により、あらゆるDingTalkグループをエージェントのコマンドセンターに変えます。

DingTalkボットのセットアップ

選択肢は2つあります。Webhook（最もシンプル、一方向）またはコールバック（全二重、メッセージ受信可能）です。本格的なアシスタントを目指すなら、コールバックを選びましょう。流れは以下の通りです。

DingTalk開発者コンソールでボットを作成します。
AppKey と AppSecret を取得します。
受信メッセージ用に公開コールバックURL（HTTPS必須）を設定します。
返信用にボットの送信Webhookを設定します。

Hermesでは、これを config.yaml で定義します。

channels:
  dingtalk:
    enabled: true
    mode: callback          # or "webhook" for one-way alerts
    app_key: "your_app_key"
    app_secret: "your_app_secret"
    callback_url: "https://your-server.com/dingtalk/callback"
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"  # for replies
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

メッセージの受信

コールバックURLが有効になると、DingTalkはすべてのグループメッセージをHermesにプッシュします。エージェントはJSONペイロードを解析し、送信者、チャットID、テキストを抽出して、スキルパイプラインにルーティングします。キーワード、メンション、特定のグループでフィルタリングすることも可能です。例えば、ボットが@メンションされた時だけ応答するようにできます。

channels:
  dingtalk:
    filters:
      require_mention: true
      allow_groups:
        - "ops-alerts"
        - "ai-assistant"

返信の送信

返信はWebhook URLを通じて送信されます。Hermesは自動的に、プレーンテキスト、マークダウン、インタラクティブカードなど、DingTalkの正しいメッセージ形式でレスポンスをラップします。以下は、挨拶をエコーバックする最小限のスキルです。

@agent.skill
async def greet(ctx, text):
    return f"Hello from Hermes! You said: {text}"

手動でのHTTP呼び出しは不要です。Hermesが署名、タイムスタンプ、JSONエンベロープをすべて処理します。

まとめ

DingTalk統合により、Hermesはターミナルだけで動くおもちゃから、中国のチームにとっての「職場の一員」へと変貌します。config.yaml に数行追加するだけで、双方向メッセージング、メンションフィルタリング、自動返信フォーマットが手に入ります。工場現場向けのQAボットを構築する場合でも、多忙なマネージャー向けのパーソナルアシスタントを構築する場合でも、Hermes + DingTalkは、あなたのAIが現代中国のオフィスの言語を、流暢かつ確実に、そしてコードベースに中国語を一切含めずに話すことを意味します。