{"id":1209,"date":"2026-07-07T10:08:09","date_gmt":"2026-07-07T02:08:09","guid":{"rendered":"http:\/\/www.max-shu.com\/blog\/?p=1209"},"modified":"2026-07-07T10:08:15","modified_gmt":"2026-07-07T02:08:15","slug":"hermes-agent%e7%9a%84%e5%ae%89%e8%a3%85%e5%92%8c%e4%bd%bf%e7%94%a8","status":"publish","type":"post","link":"https:\/\/www.max-shu.com\/blog\/?p=1209","title":{"rendered":"hermes agent\u7684\u5b89\u88c5\u548c\u4f7f\u7528"},"content":{"rendered":"\n

hermes agent\u5b8c\u5168\u53ef\u4ee5\u4e0d\u4ece\u516c\u7f51\u8bbf\u95ee\u5b83\uff0c\u4f46\u662f\u5b83\u5fc5\u987b\u80fd\u8bbf\u95ee\u516c\u7f51\u3002<\/p>\n\n\n\n

hermes agent\u7684Docker\u65b9\u5f0f\u5b89\u88c5<\/strong>\uff1a<\/p>\n\n\n\n

\u9996\u6b21\u5b89\u88c5<\/strong>\uff08\u955c\u50cf5GB\u591a\u633a\u5927\uff0c\u4f7f\u7528\u7684Debian 13 linux\uff09\uff1a<\/p>\n\n\n\n

# setenforce 0<\/p>\n\n\n\n

# dnf upgrade crun<\/p>\n\n\n\n

# mkdir \/root\/hermes_agent\/global_agent<\/p>\n\n\n\n

# docker run -it –rm -v \/root\/hermes_agent\/global_agent:\/opt\/data  nousresearch\/hermes-agent:v2026.5.7 setup<\/p>\n\n\n\n

\u8868\u793a\u5728docker\u91cc\u9762\u6267\u884c\uff1a\/opt\/hermes\/.venv\/bin\/hermes setup\u547d\u4ee4\u3002<\/p>\n\n\n\n

\u914d\u7f6e\u548c\u98de\u4e66\u7684chat id\uff08\u7fa4\u804a\u624d\u80fd\u7528\uff09: global_agent<\/p>\n\n\n\n

\u518d\u6b21\u4ee5\u7f51\u5173\u65b9\u5f0f\u542f\u52a8<\/strong>\uff1a<\/p>\n\n\n\n

# docker run -d –name hermes_global_agent –restart unless-stopped -v \/root\/hermes_agent\/global_agent:\/opt\/data -p 8642:8642 -e TZ=Asia\/Shanghai nousresearch\/hermes-agent:v2026.5.7 gateway run<\/p>\n\n\n\n

\u98de\u4e66\u673a\u5668\u4eba\u914d\u7f6e\uff1a\u5fc5\u987b\u4ee5websocket\u957f\u8fde\u63a5\u65b9\u5f0f\uff0c\u4e8b\u4ef6\u914d\u7f6e: \u6dfb\u52a0im.message.receive_v1\u4e8b\u4ef6, \u56de\u8c03\u914d\u7f6e: \u6dfb\u52a0card.action.trigger\u56de\u8c03\u3002\u5728\u98de\u4e66\u7fa4\u7ec4\u91cc\u4e0d\u80fd\u7528”@\u673a\u5668\u4eba”\u65b9\u5f0f\u4f7f\u7528”\/cron”\u7b49\u659c\u6760\u7c7b\u7684\u547d\u4ee4\u3002<\/p>\n\n\n\n

\u6839\u636e\u7528\u6237\u6307\u793a\u4e34\u65f6\u751f\u6210\u7684python\u6587\u4ef6\u3001\u7ed3\u679c\u6587\u4ef6\u90fd\u5728\u5bb9\u5668\u91cc\u9762\u7684\/tmp\/\u76ee\u5f55\u4e0b\uff0cstop\u5bb9\u5668\u518dstart\u8fd8\u4f1a\u4fdd\u7559\uff0c\u4e0d\u4f1a\u6e05\u9664\u6389\u3002<\/p>\n\n\n\n

\u5347\u7ea7<\/strong>\uff1a<\/p>\n\n\n\n

# docker stop hermes_global_agent<\/p>\n\n\n\n

# docker rm hermes_global_agent<\/p>\n\n\n\n

# docker pull nousresearch\/hermes-agent:v2026.5.7<\/p>\n\n\n\n

\u7136\u540e\u6267\u884c\u4e0a\u9762\u7684\u7f51\u5173\u65b9\u5f0f\u542f\u52a8\u5373\u53ef(\u4e0d\u7528\u518dsetup\u521d\u59cb\u5316)\u3002<\/p>\n\n\n\n

\u628a\/opt\/hermes\/\u76ee\u5f55\u6620\u5c04\u5230host\uff0c\u65b9\u4fbf\u4fee\u6539\u4ee3\u7801<\/strong>\uff1a<\/p>\n\n\n\n

\u6ce8\u610f\uff1a\u5fc5\u987b\u662f\u5148\u4ece\u5bb9\u5668\u91cc\u62f7\u8d1d\u51fa\u6765\uff0c\u518d\u91cd\u5efa\u5bb9\u5668\u65f6\u6620\u5c04\u8fdb\u53bb\uff0c\u5982\u679c\u9996\u6b21\u5efa\u5bb9\u5668\u76f4\u63a5\u6620\u5c04\u7684\u8bdd\u4f1a\u5bfc\u81f4\u5bb9\u5668\u8d77\u4e0d\u6765\u3002<\/p>\n\n\n\n

# mkdir \/root\/hermes_agent\/global_agent_opt_hermes<\/p>\n\n\n\n

# chown -R 10000:10000 \/root\/hermes_agent\/global_agent_opt_hermes<\/p>\n\n\n\n

# rm -rf \/root\/hermes_agent\/global_agent_opt_hermes<\/p>\n\n\n\n

# docker cp hermes_global_agent:\/opt\/hermes  \/root\/hermes_agent\/global_agent_opt_hermes<\/p>\n\n\n\n

# docker stop hermes_global_agent<\/p>\n\n\n\n

# docker rm hermes_global_agent<\/p>\n\n\n\n

# docker run -d –name hermes_global_agent –restart unless-stopped -v \/root\/hermes_agent\/global_agent:\/opt\/data -v \/root\/hermes_agent\/global_agent_opt_hermes\/hermes:\/opt\/hermes -p 8642:8642 -e TZ=Asia\/Shanghai nousresearch\/hermes-agent:v2026.5.7 gateway run<\/p>\n\n\n\n

\u8fdb\u5165docker\u91cc\u9762root\u7528\u6237\u7684bash<\/strong>\uff1a<\/p>\n\n\n\n

# docker exec -it hermes_global_agent  \/bin\/bash<\/p>\n\n\n\n

\u5728docker\u91cc\u9762\u589e\u52a0\u7f16\u8f91vi\u547d\u4ee4(\u6709\u5185\u7f6enano\u4ee3\u66ff)\u548c\u914d\u7f6e\u65f6\u533a\u3001\u8def\u5f84\u7b49\uff1a<\/p>\n\n\n\n

# apt-get install -y vim<\/p>\n\n\n\n

# vi \/etc\/bash.bashrc<\/p>\n\n\n\n

…<\/p>\n\n\n\n

alias ll=’ls -lF’<\/p>\n\n\n\n

export TZ=Asia\/Shanghai<\/p>\n\n\n\n

export PATH=$PATH:\/opt\/hermes\/.venv\/bin\/<\/p>\n\n\n\n

\u91cd\u542f\u5bb9\u5668\uff0c\u5207\u6362\u5230hermes\u7528\u6237\u6267\u884c\u547d\u4ee4\uff1a<\/p>\n\n\n\n

# docker restart hermes_global_agent<\/p>\n\n\n\n

# docker exec -u hermes -it hermes_global_agent  \/bin\/bash<\/p>\n\n\n\n

\u5728docker\u91cc\u9762\u6267\u884c\u547d\u4ee4\uff1a<\/p>\n\n\n\n

$ date<\/p>\n\n\n\n

$ \/opt\/hermes\/.venv\/bin\/hermes –version<\/p>\n\n\n\n

$ hermes –version<\/p>\n\n\n\n

Hermes Agent v0.11.0 (2026.4.23)<\/p>\n\n\n\n

Project: \/opt\/hermes<\/p>\n\n\n\n

Python: 3.13.5<\/p>\n\n\n\n

OpenAI SDK: 2.32.0<\/p>\n\n\n\n

$ hermes chat<\/p>\n\n\n\n

$ exit<\/p>\n\n\n\n

hermes agent\u7684\u76f4\u63a5\u670d\u52a1\u5668\u65b9\u5f0f\u5b89\u88c5<\/strong>\uff1a<\/p>\n\n\n\n

\u963f\u91cc\u4e91\u4e0a\u641e\u4e00\u53f0ECS\u4e3b\u673a(ubuntu 24.x)\u6765\u5b89\u88c5\uff0c\u5e76\u4e14\u6302\u8f7d\u4e00\u4e2a\u963f\u91cc\u4e91nas\u76ee\u5f55\u5230ubuntu\u7684 \/home\/ \u76ee\u5f55\u3002<\/p>\n\n\n\n

\u5b89\u88c5\uff1a<\/strong><\/p>\n\n\n\n

# ln \/usr\/bin\/python3 \/usr\/bin\/python<\/p>\n\n\n\n

# apt install ripgrep ffmpeg <\/p>\n\n\n\n

# apt install build-essential python3-dev libffi-dev<\/p>\n\n\n\n

# apt install playwright chromium<\/p>\n\n\n\n

# adduser hermes<\/p>\n\n\n\n

# visudo<\/p>\n\n\n\n

…<\/p>\n\n\n\n

hermes  ALL=(ALL) NOPASSWD: ALL<\/p>\n\n\n\n

…<\/p>\n\n\n\n

# su – hermes<\/p>\n\n\n\n

$ wgethttps:\/\/hermes-agent.nousresearch.com\/install.sh<\/a><\/p>\n\n\n\n

$ chmod +x install.sh<\/p>\n\n\n\n

$ .\/install.sh –branch v2026.6.19 –skip-setup<\/p>\n\n\n\n

\u5b89\u88c5\u540e\u7684\u8def\u5f84\uff1a<\/p>\n\n\n\n

   Config:    \/home\/hermes\/.hermes\/config.yaml<\/p>\n\n\n\n

   API Keys:  \/home\/hermes\/.hermes\/.env<\/p>\n\n\n\n

   Data:      \/home\/hermes\/.hermes\/cron\/, sessions\/, logs\/<\/p>\n\n\n\n

   Code:      \/home\/hermes\/.hermes\/hermes-agent<\/p>\n\n\n\n

$ exit \u56e0\u4e3abashrc\u88ab\u6539\u6240\u4ee5\u9700\u8981\u91cd\u65b0\u8fdb\u5165bash\u3002<\/p>\n\n\n\n

$ hermes version<\/p>\n\n\n\n

Hermes Agent v0.13.0 (2026.5.7)<\/p>\n\n\n\n

Project: \/home\/hermes\/.hermes\/hermes-agent<\/p>\n\n\n\n

Python: 3.11.15<\/p>\n\n\n\n

\u521d\u59cb\u5316\u914d\u7f6e<\/strong>\uff1a<\/p>\n\n\n\n

$ hermes setup<\/p>\n\n\n\n

\u6839\u636e\u63d0\u793a\u5efa\u7acb\u521d\u59cb\u5316\u914d\u7f6e<\/p>\n\n\n\n

\u4f5c\u4e3aservice\u542f\u52a8gateway\uff0csudo\u5230root\u7528\u6237\u6267\u884c\uff1a<\/strong><\/p>\n\n\n\n

$ hermes gateway -h<\/p>\n\n\n\n

$ sudo \/home\/hermes\/.local\/bin\/hermes gateway install –system –run-as-user hermes<\/p>\n\n\n\n

\u4f1a\u5efa\u7acb\u8fd9\u4e2aservice\uff1a\/etc\/systemd\/system\/hermes-gateway.service\uff0c\u7136\u540e\u542f\u52a8\uff1a<\/p>\n\n\n\n

$ sudo \/home\/hermes\/.local\/bin\/hermes gateway start –system<\/p>\n\n\n\n

$ sudo \/home\/hermes\/.local\/bin\/hermes gateway status –system<\/p>\n\n\n\n

$ sudo systemctl start hermes-gateway<\/p>\n\n\n\n

$ sudo systemctl stop hermes-gateway<\/p>\n\n\n\n

$ sudo systemctl status hermes-gateway<\/p>\n\n\n\n

\u540e\u7eed\u6d4b\u8bd5\u4e2d\u8981\u7528\u76f8\u540cpython\u7248\u672c\u6267\u884c\u7684\u8bdd<\/strong>(VENV\u65b9\u5f0f)\uff1a<\/p>\n\n\n\n

$ source .hermes\/hermes-agent\/venv\/bin\/activate<\/p>\n\n\n\n

$ python -V<\/p>\n\n\n\n

\u5347\u7ea7<\/strong>\uff08\u53ea\u80fd\u5347\u7ea7\u5230main\u5206\u652f\u7684\u6700\u65b0\u4f4d\u7f6e\uff09\uff1a<\/p>\n\n\n\n

$ hermes update -h<\/p>\n\n\n\n

hermes update –check<\/p>\n\n\n\n

\/\/hermes update –backup \u9700\u8981\u6bd4\u8f83\u4e45\uff0c\u63a5\u53d7\u98ce\u9669\u4e0d\u7528\u4e5f\u53ef\u4ee5<\/p>\n\n\n\n

hermes update <\/p>\n\n\n\n

tail -f ~\/.hermes\/logs\/update.log<\/p>\n\n\n\n

hermes –version<\/p>\n\n\n\n

hermes config check<\/p>\n\n\n\n

hermes setup –migrate<\/p>\n\n\n\n

hermes doctor<\/p>\n\n\n\n

\/\/sudo systemctl restart hermes-gateway \u4f1a\u81ea\u52a8\u91cd\u542f<\/p>\n\n\n\n

hermes gateway status<\/p>\n\n\n\n

\u4f7f\u7528\uff1a<\/strong><\/p>\n\n\n\n

    hermes -h<\/p>\n\n\n\n

\u521d\u59cb\u5316\u547d\u4ee4\uff1a<\/strong><\/p>\n\n\n\n

   hermes setup -h<\/p>\n\n\n\n

   hermes setup          Re-run the full wizard<\/p>\n\n\n\n

   hermes setup model    Change model\/provider<\/p>\n\n\n\n

   hermes setup terminal Change terminal backend<\/p>\n\n\n\n

   hermes setup gateway  Configure messaging<\/p>\n\n\n\n

   hermes setup tools    Configure tool providers<\/p>\n\n\n\n

   hermes config         View current settings<\/p>\n\n\n\n

   hermes config edit    Open config in your editor<\/p>\n\n\n\n

   hermes config set <key> <value> Set a specific value<\/p>\n\n\n\n

\u914d\u7f6e\u6587\u4ef6\u4f4d\u7f6e\uff1a<\/strong><\/p>\n\n\n\n

   \/opt\/data\/config.yaml\uff1a \u5bf9\u5e94\u4e3b\u673a\u7684\/root\/hermes_agent\/global_agent\/config.yaml\u6587\u4ef6\uff08\u53c2\u8003docker\u542f\u52a8\u547d\u4ee4\u7684-v\u53c2\u6570\uff09<\/p>\n\n\n\n

   \/opt\/data\/.env<\/p>\n\n\n\n

\u542f\u52a8\u547d\u4ee4\uff1a<\/strong><\/p>\n\n\n\n

   hermes         \u9ed8\u8ba4chat\u6a21\u5f0f\u542f\u52a8<\/p>\n\n\n\n

   hermes chat    \u4ee5chat\u6a21\u5f0f\u542f\u52a8\uff0c\u8fdb\u5165\u540e\/help\u53ef\u4ee5\u770b\u5230\u5185\u7f6e\u7684\u4ea4\u4e92\u547d\u4ee4\uff0c\/exit\u547d\u4ee4\u9000\u51fa\u3002<\/p>\n\n\n\n

   hermes gateway \u4ee5\u7f51\u5173\u65b9\u5f0f\u542f\u52a8\u548c\u98de\u4e66\u7b49\u4ea4\u4e92<\/p>\n\n\n\n

   hermes doctor  \u68c0\u67e5\u95ee\u9898\u6a21\u5f0f\u542f\u52a8<\/p>\n\n\n\n

\u914d\u7f6elog\u7ea7\u522b<\/strong>\uff08DEBUG\u7ea7\u522b\u53ef\u4ee5\u770b\u5230\u548c\u6a21\u578b\u7684\u4ea4\u4e92\uff0c\u6253\u5370\u4f1a\u5f88\u591a\uff0c\u8c28\u614e\uff09\uff1a<\/p>\n\n\n\n

\u4fee\u6539config.yaml:<\/p>\n\n\n\n

…<\/p>\n\n\n\n

logging:<\/p>\n\n\n\n

  level: DEBUG<\/p>\n\n\n\n

\u4f7f\u7528\u591a\u6a21\u578b\uff1a<\/strong><\/p>\n\n\n\n

\u5176\u5b9e\u4f7f\u7528openrouter\u76f4\u63a5\u4f5c\u4e3a\u4e3b\u6a21\u578bapi key\uff0c\u7136\u540e\u8ba9openrouter\u81ea\u884c\u9009\u66f4\u597d\u3002<\/p>\n\n\n\n

$ hermes fallback -h<\/p>\n\n\n\n

$ hermes fallback add<\/p>\n\n\n\n

(\u25cb) Configure auxiliary models…  \u8fd9\u9879\u662f\u4fee\u6539\u8f85\u52a9\u6a21\u578b\uff0c\u9009\u5176\u4ed6\u9879\u5219\u662f\u9009fallback\u6a21\u578b\u3002<\/p>\n\n\n\n

\u4f7f\u7528\u591aprofile\u5efa\u7acb\u591aagent\u5bf9\u5e94\u5230\u591a\u4e2a\u98de\u4e66\u673a\u5668\u4eba<\/strong>\uff1a<\/p>\n\n\n\n

\u6ce8\u610f\uff1a\u98de\u4e66\u673a\u5668\u4eba\u4e0d\u80fd\u91cd\u590d\u7528\uff0c\u4e00\u4e2aagent\u5bf9\u5e94\u4e00\u4e2a\u3002<\/p>\n\n\n\n

$ hermes profile -h<\/p>\n\n\n\n

$ hermes profile list<\/p>\n\n\n\n

$ hermes profile create test_1<\/p>\n\n\n\n

\u5728profiles\/test_1\u76ee\u5f55\u4e0b\u5efa\u7acb\u4e86\u65b0\u7684profile\uff0c\u540e\u7eed\u53ef\u4ee5\u7528test_1\u76f4\u63a5\u66ff\u6362hermes\u547d\u4ee4\u4f7f\u7528\u8be5profile\uff0c\u6bd4\u5982\uff1a<\/p>\n\n\n\n

$ which test_1<\/p>\n\n\n\n

\/home\/hermes\/.local\/bin\/test_1<\/p>\n\n\n\n

$ test_1 setup<\/p>\n\n\n\n

$ test_1 chat<\/p>\n\n\n\n

$ test_1 gateway run <\/p>\n\n\n\n

$ test_1 gateway install  \u540c\u6837\u53ef\u4ee5\u4f5c\u4e3a\u7cfb\u7edf\u670d\u52a1\u5b89\u88c5\u81ea\u52a8\u542f\u52a8<\/p>\n\n\n\n

$ test_1 gateway start<\/p>\n\n\n\n

$ test_1 gateway status  \u901a\u8fc7systemctl \u662f\u770b\u4e0d\u5230\u8be5\u670d\u52a1\u7684<\/p>\n\n\n\n

$ test_1 gateway stop<\/p>\n\n\n\n

$ test_1 gateway uninstall<\/p>\n\n\n\n

\u5176\u5b9etest_1\u662f\u4e2a\u811a\u672c\uff0c\u5b9e\u9645\u6267\u884c\u7684\u662fhermes -p test_1\u5e26\u540e\u9762\u7684\u53c2\u6570\u3002<\/p>\n\n\n\n

\u53ef\u4ee5\u5bfc\u5165\u5bfc\u51fa\uff1a<\/p>\n\n\n\n

$ hermes gateway list<\/p>\n\n\n\n

$ hermes profile export test_1<\/p>\n\n\n\n

$ hermes profile import test_1<\/p>\n\n\n\n

\u7f16\u8f91SOUL.md\u6587\u4ef6\u5b9a\u4e49\u7075\u9b42\uff1a<\/strong><\/p>\n\n\n\n

# vi SOUL.md<\/p>\n\n\n\n

\u4f60\u662f\u4e00\u4e2a\u4e13\u4e1a\u7684\u6e38\u620f\u884c\u4e1a\u4ece\u4e1a\u8005\u3002<\/p>\n\n\n\n

\u4f60\u662f\u4e00\u4e2a\u4e13\u4e1a\u7684\u6570\u636e\u5206\u6790\u5e08\u3002<\/p>\n\n\n\n

\u4f60\u662f\u4e00\u4e2a\u53ef\u4ee5\u5229\u7528\u5404\u79cdAPI\u64cd\u4f5c\u6e38\u620f\u6295\u653e\u548c\u53d8\u73b0\u7684\u4e13\u4e1a\u4eba\u5458\u3002<\/p>\n\n\n\n

\u4f60\u7edd\u5bf9\u4e0d\u4f1a\u6267\u884cbigquery\u3001mysql\u6570\u636e\u5e93\u7684\u4efb\u4f55\u5220\u9664\u548c\u66f4\u65b0\u64cd\u4f5c\uff0c\u53ea\u505a\u67e5\u8be2\u3002<\/p>\n\n\n\n

…<\/p>\n\n\n\n

\u5b9a\u65f6\u4efb\u52a1<\/strong>\uff08\u4fdd\u5b58\u5728\/opt\/data\/cron\/jobs.json\u6587\u4ef6\u91cc\uff09\uff1a<\/p>\n\n\n\n

\u6ce8\u610f\uff1a\u53ef\u4ee5\u5728hermes chat\u91cc\u9762\u76f4\u63a5\u5efa\u7acb\uff0c\u4e5f\u53ef\u4ee5\u5728\u98de\u4e66\u5355\u804a\u91cc\u9762\u53d1\u6d88\u606f\u5efa\u7acb\uff0c\u98de\u4e66\u4e2d\u659c\u6760\u547d\u4ee4\u548cchat\u91cc\u9762\u7684\u659c\u6760\u547d\u4ee4\u662f\u4e0d\u4e00\u6837\u7684\uff0c\u98de\u4e66\u53ea\u662f\u5b50\u96c6\u3002<\/p>\n\n\n\n

# docker exec -u hermes -it d360b120dc3b  \/bin\/bash<\/p>\n\n\n\n

$ hermes chat<\/p>\n\n\n\n

\/cron<\/p>\n\n\n\n

\/cron list<\/p>\n\n\n\n

\/cron add “every 2h” “Check server status” [–skill blogwatcher]<\/p>\n\n\n\n

\/cron edit <job_id> \u3002\u3002\u3002<\/p>\n\n\n\n

\/cron pause <job_id><\/p>\n\n\n\n

\/cron resume <job_id><\/p>\n\n\n\n

\/cron run <job_id><\/p>\n\n\n\n

\/cron remove <job_id><\/p>\n\n\n\n

\u662f\u5426\u5728\u5bf9\u8bdd\u4e2d\u663e\u793a\u8c03\u7528\u5de5\u5177\u7c7b\u8fdb\u5ea6\u914d\u7f6e<\/strong>\uff1a<\/p>\n\n\n\n

$ vi config.yaml<\/p>\n\n\n\n

…<\/p>\n\n\n\n

display:<\/p>\n\n\n\n

    tool_progress: verbose  # all\/off\/new\/verbose<\/p>\n\n\n\n

\u53d1\u9001\u5b9a\u65f6\u4efb\u52a1\u7684\u6d88\u606f\u7ed9\u98de\u4e66\u7684\u6307\u5b9a\u63a5\u6536\u4eba<\/strong>\uff1a<\/p>\n\n\n\n

\u6ce8\u610f\uff1a\u63a5\u6536\u4eba\u5fc5\u987b\u80fd\u88ab\u8bc6\u522b\uff0c\u6bd4\u5982\u5df2\u7ecf\u4e0e\u673a\u5668\u4eba\u5bf9\u8bdd\u8fc7\u7684\u4eba\u5458\u6216\u8005\u673a\u5668\u4eba\u6240\u5728\u7fa4\u7ec4\u3002<\/p>\n\n\n\n

\u76f4\u63a5\u5728hermes chat\u6216\u8005\u98de\u4e66\u5355\u804a\u91cc\u9762\u8f93\u5165\u7c7b\u4f3c\u6d88\u606f\u5373\u53ef\uff1a \u6bcf\u5206\u949f\u5411\u201c\u6d4b\u8bd5ai\u7fa4\u804a\u529f\u80fd\u201d \u7fa4\u7ec4\u53d1\u9001”\u4f60\u597d”\u6d88\u606f<\/p>\n\n\n\n

\u76f4\u63a5\u5728hermes chat\u6216\u8005\u98de\u4e66\u5355\u804a\u91cc\u9762\u8f93\u5165\u7c7b\u4f3c\u6d88\u606f\u5373\u53ef\uff1a \u6bcf10\u5206\u949f\u5411\u201c\u6d4b\u8bd5ai\u7fa4\u804a\u529f\u80fd\u201d \u7fa4\u7ec4\u7684”\u5f20\u4e09”\u53d1\u9001”\u4f60\u597d”\u6d88\u606f<\/p>\n\n\n\n

\u5728\u56de\u590d\u5e26\u6709\u56de\u590d\u6d88\u606f\u7684\u6d88\u606f\u65f6\uff0c\u4e0d\u8981\u81ea\u52a8\u521b\u5efa\u98de\u4e66\u8bdd\u9898\uff1a<\/strong><\/p>\n\n\n\n

$ vi gateway\/platforms\/feishu.py<\/p>\n\n\n\n

…<\/p>\n\n\n\n

        # thread_id = getattr(message, “thread_id”, None) or getattr(message, “root_id”, None) or None<\/p>\n\n\n\n

        thread_id = getattr(message, “thread_id”, None) or None<\/p>\n\n\n\n

        reply_to_message_id = (<\/p>\n\n\n\n

\u627e\u5230skill\u63a5\u5165<\/strong>\uff1a<\/p>\n\n\n\n

\u4ece\u8fd9\u91cc\u53ef\u4ee5\u627e\u5230\u4e00\u4e9b\u5b98\u65b9\u7684\u76f4\u63a5\u5b89\u88c5\uff0c\u5b89\u88c5\u540e\u7684\u76ee\u5f55\u5728skills\/\u4e0b\u9762<\/p>\n\n\n\n

https:\/\/hermes-agent.nousresearch.com\/docs\/skills<\/a><\/p>\n\n\n\n

$ hermes skills install google-sheets  –force<\/p>\n\n\n\n

$ hermes skills list<\/p>\n\n\n\n

$ ls -l \/opt\/data\/skills\/google-sheets\/<\/p>\n\n\n\n

$ vi \/opt\/data\/.env<\/p>\n\n\n\n

…<\/p>\n\n\n\n

MATON_API_KEY=v2.8hhhhAAAAAA<\/p>\n\n\n\n

$ hermes chat<\/p>\n\n\n\n

> \u770b\u4e0b\u8fd9\u4e2a\u8868\u91cc\u5e7f\u544a\u7684\u603b\u4ef7\u683c\uff1ahttps:\/\/docs.google.com\/spreadsheets\/d\/1U9vnxvPUCs0qCKQy1IQ68Ei0o5rIPcZg879ir82SVek\/edit?gid=0#gid=0<\/a><\/p>\n\n\n\n

\u7f16\u5199\u81ea\u5df1\u7684SKILL<\/strong>\uff1a<\/p>\n\n\n\n

$ mkdir skills\/feishu_button_text_interactive<\/p>\n\n\n\n

$ vi skills\/feishu_button_text_interactive\/SKILL.md<\/p>\n\n\n\n

—<\/p>\n\n\n\n

name: feishu_interactive<\/p>\n\n\n\n

description: “\u98de\u4e66\u673a\u5668\u4eba\u56de\u590d\u7684\u6d88\u606f\u7684\u5c3e\u90e8\u52a0\u5165\u6309\u94ae\u5e76\u63a5\u53d7\u6309\u94ae\u53cd\u9988”<\/p>\n\n\n\n

version: 1.0.0<\/p>\n\n\n\n

author: Zhang san<\/p>\n\n\n\n

license: MIT<\/p>\n\n\n\n

metadata:<\/p>\n\n\n\n

  hermes:<\/p>\n\n\n\n

    tags: [Feishu, \u6d88\u606f, \u6309\u94ae]<\/p>\n\n\n\n

    related_skills: []<\/p>\n\n\n\n

—<\/p>\n\n\n\n

# Agent\u56de\u590d\u7684\u98de\u4e66\u6d88\u606f\u5c3e\u90e8\u52a0\u5165\u6309\u94ae\u5e76\u63a5\u53d7\u6309\u94ae\u53cd\u9988<\/p>\n\n\n\n

AI Agent\u6bcf\u6b21\u56de\u590d\u98de\u4e66\u6d88\u606f\u65f6\uff0c\u5728\u98de\u4e66\u5c3e\u90e8\u52a0\u5165\u6309\u94ae\uff0c\u5728\u7528\u6237\u70b9\u51fb\u6309\u94ae\u7ed9\u51fa\u53cd\u9988\u65f6\uff0c\u4fdd\u5b58\u53cd\u9988\u4fe1\u606f\u3002<\/p>\n\n\n\n

## \u5148\u51b3\u6761\u4ef6<\/p>\n\n\n\n

– \u6536\u5230\u98de\u4e66\u8bf7\u6c42AI\u6267\u884c\u67d0\u9879\u529f\u80fd\u7684\u6d88\u606f<\/p>\n\n\n\n

– AI\u9700\u8981\u56de\u590d\u98de\u4e66\u6d88\u606f<\/p>\n\n\n\n

## \u6267\u884c<\/p>\n\n\n\n

– Agent\u56de\u590d\u6d88\u606f\u7684\u65f6\u5019\u52a0\u5165\u4e00\u4e2a\u6309\u94ae\uff0c\u6309\u94ae\u5185\u5bb9\u4e3a”\u6ee1\u610f”<\/p>\n\n\n\n

– \u7528\u6237\u5728\u98de\u4e66\u804a\u5929\u70b9\u51fb”\u6ee1\u610f”\u65f6\uff0cAgent\u5728log\u91cc\u8f93\u51fa \u7528\u6237id\u3001\u65f6\u95f4\u3001\u53cd\u9988\u6ee1\u610f<\/p>\n\n\n\n

\u627e\u5230mcp server\u63a5\u5165<\/strong>\uff1a<\/p>\n\n\n\n

\u914d\u7f6ebigquery\u7684\u5b98\u65b9mcp\uff08\u4e0d\u518d\u597d\u7528<\/strong>\uff09\uff1a<\/p>\n\n\n\n

\u5728\u6709glcoud\u7684host\u4e3b\u673a\u4e0a\u6267\u884c\u5373\u53ef(\u4e0d\u7528\u5728docker\u5bb9\u5668\u91cc\u9762)\uff0c\u542f\u7528bigquery\u9879\u76ee\u7684mcp server\uff1a<\/p>\n\n\n\n

# gcloud beta services mcp enable\u00a0\u00a0bigquery.googleapis.com<\/a> –project=data-collect<\/p>\n\n\n\n

# gcloud beta services mcp disable bigquery.googleapis.com<\/a> –project=data-collect<\/p>\n\n\n\n

\u542f\u7528\u540e\uff0c\u56de\u6765\u4fee\u6539\u914d\u7f6e\uff0c\u8fd9\u7c7b\u4fee\u6539\u90fd\u53ef\u4ee51\u5206\u949f\u5185\u76f4\u63a5\u751f\u6548\uff0c\u4e0d\u7528\u91cd\u542fdocker\uff1a<\/p>\n\n\n\n

$ vi config.yaml<\/p>\n\n\n\n

…<\/p>\n\n\n\n

mcp_servers:<\/p>\n\n\n\n

  bigquery:<\/p>\n\n\n\n

    url: https:\/\/bigquery.googleapis.com\/mcp<\/a><\/p>\n\n\n\n

    env:<\/p>\n\n\n\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0GOOGLE_CLOUD_PROJECT: data-collect<\/p>\n\n\n\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0GOOGLE_APPLICATION_CREDENTIALS: \/opt\/data\/common_config\/data-collect-11111111.json<\/p>\n\n\n\n

\u7f16\u5199\u81ea\u5df1\u7684MCP Server<\/strong>\uff1a<\/p>\n\n\n\n

$ mkdir skills\/mcp_test\/<\/p>\n\n\n\n

$ vi skills\/mcp_test\/my_ip.py<\/p>\n\n\n\n

# \/\/\/ script<\/p>\n\n\n\n

# dependencies = [<\/p>\n\n\n\n

#   “fastmcp”,<\/p>\n\n\n\n

#   “mcp”,<\/p>\n\n\n\n

#   “httpx”,<\/p>\n\n\n\n

# ]<\/p>\n\n\n\n

# \/\/\/<\/p>\n\n\n\n

from mcp.server.fastmcp import FastMCP<\/p>\n\n\n\n

import httpx<\/p>\n\n\n\n

mcp = FastMCP(“\u6211\u7684\u516c\u7f51IP\u548c\u5730\u7406\u4f4d\u7f6e”)<\/p>\n\n\n\n

@mcp.tool()<\/p>\n\n\n\n

async def get_ip_info() -> str:<\/p>\n\n\n\n

    “””<\/p>\n\n\n\n

    \u83b7\u53d6\u5f53\u524d\u51fa\u53e3 IP \u7684\u5730\u7406\u4f4d\u7f6e\u4fe1\u606f<\/p>\n\n\n\n

    \u5f53\u7528\u6237\u8f93\u5165\u6211\u7684\u51fa\u53e3ip\u3001\u6211\u7684\u516c\u7f51ip\u3001\u6211\u7684\u5916\u7f51ip\u7684\u65f6\u5019\u8c03\u7528\u8be5\u5de5\u5177<\/p>\n\n\n\n

    \u53c2\u6570\uff1a<\/p>\n\n\n\n

        \u65e0<\/p>\n\n\n\n

    “””<\/p>\n\n\n\n

    async with httpx.AsyncClient() as client:<\/p>\n\n\n\n

        resp = await client.get(“https:\/\/ipapi.co\/json\/<\/a>“)<\/p>\n\n\n\n

        data = resp.json()<\/p>\n\n\n\n

        return f”IP: {data.get(‘ip’)}, \u57ce\u5e02: {data.get(‘city’)}, \u8fd0\u8425\u5546: {data.get(‘org’)}”<\/p>\n\n\n\n

if __name__ == “__main__”:<\/p>\n\n\n\n

    mcp.run(transport=”stdio”)<\/p>\n\n\n\n

\u5148\u7528uvx\u6d4b\u8bd5\u4e00\u4e0b\uff1a<\/p>\n\n\n\n

$ uvx –with mcp python \/opt\/data\/skills\/maxshu_test\/mcp_test\/my_ip.py<\/p>\n\n\n\n

\u5148\u8f93\u5165json\u683c\u5f0f\u521d\u59cb\u5316\u670d\u52a1\uff1a<\/p>\n\n\n\n

{“jsonrpc”: “2.0”, “id”: 1, “method”: “initialize”, “params”: {“capabilities”: {}, “clientInfo”: {“name”: “test-client”, “version”: “1.0”}, “protocolVersion”: “2024-11-05”}}<\/p>\n\n\n\n

\u8fd4\u56de\uff1a<\/p>\n\n\n\n

{“jsonrpc”:”2.0″,”id”:1,”result”:{“protocolVersion”:”2024-11-05″,”capabilities”:{“experimental”:{},”prompts”:{“listChanged”:false},”resources”:{“subscribe”:false,”listChanged”:false},”tools”:{“listChanged”:false}},”serverInfo”:{“name”:”\u6211\u7684\u516c\u7f51IP\u548c\u5730\u7406\u4f4d\u7f6e”,”version”:”1.27.0″}}}<\/p>\n\n\n\n

\u518d\u8f93\u5165\u5bf9tool\u7684\u8c03\u7528\uff1a<\/p>\n\n\n\n

{“jsonrpc”: “2.0”, “id”: 2, “method”: “tools\/call”, “params”: {“name”: “get_ip_info”, “arguments”: {}}}<\/p>\n\n\n\n

\u8fd4\u56de\uff1a<\/p>\n\n\n\n

{“jsonrpc”:”2.0″,”id”:2,”result”:{“content”:[{“type”:”text”,”text”:”IP: 123.123.123.123, \u57ce\u5e02: \u6d4b\u8bd5\u57ce\u5e02, \u8fd0\u8425\u5546: \u6d4b\u8bd5\u8fd0\u8425\u5546”}],”structuredContent”:{“result”:”IP: 123.123.123.123, \u57ce\u5e02: \u6d4b\u8bd5\u57ce\u5e02, \u8fd0\u8425\u5546: \u6d4b\u8bd5\u8fd0\u8425\u5546”},”isError”:false}}<\/p>\n\n\n\n

\u7136\u540e\u914d\u7f6e\u5230hermes\uff1a<\/p>\n\n\n\n

$ vi config.yaml<\/p>\n\n\n\n

…<\/p>\n\n\n\n

  my_ip_position:<\/p>\n\n\n\n

    command: “uvx”<\/p>\n\n\n\n

    args:<\/p>\n\n\n\n

      – “–with”<\/p>\n\n\n\n

      – “mcp”<\/p>\n\n\n\n

      – “python”<\/p>\n\n\n\n

      – “\/opt\/data\/skills\/mcp_test\/my_ip.py”<\/p>\n\n\n\n

    env:<\/p>\n\n\n\n

      TESTA: not_use<\/p>\n\n\n\n

    enabled: true<\/p>\n\n\n\n

\u6d4b\u8bd5\u4e00\u4e0b\uff1a<\/p>\n\n\n\n

$ hermes mcp list<\/p>\n\n\n\n

$ hermes mcp test my_ip_position<\/p>\n\n\n\n

\u8f93\u51famcp\u91cc\u9762\u7684tool\u5de5\u5177\u540d\u548c\u6ce8\u91ca\u8868\u793a\u6b63\u5e38\u53ef\u4ee5\u4f7f\u7528\u4e86\u3002<\/p>\n\n\n\n

$ hermes chat<\/p>\n\n\n\n

> \u6211\u7684\u516c\u7f51ip<\/p>\n\n\n\n

\u7b2c\u4e00\u6b21\u5403\u53ef\u80fd\u8981\u6307\u5b9a\u4f7f\u7528\u8be5mcp\u670d\u52a1\uff0c\u7136\u540e\u4ea4\u4e92\u51e0\u6b21\uff0c\u540e\u7eed\u80fd\u770b\u5230\u8c03\u7528\u4e86\u8fd9\u4e2amcp\u670d\u52a1\u3002<\/p>\n\n\n\n

\u9650\u5236\u98de\u4e66\u4ea4\u4e92\u4e2d\u80fd\u7528\u7684\u659c\u6760\u7c7b\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n

\u53ea\u80fd\u4fee\u6539\u6e90\u7801\uff0c\u4fee\u6539 hermes_cli\/commands.py \u91cc\u9762\u7684 COMMAND_REGISTRY \u5e38\u91cf\u5b9a\u4e49\uff0c\u4e0d\u8ba9\u804a\u5929\u4ea4\u4e92\u7684\u547d\u4ee4\u589e\u52a0 “cli_only=True” \u5373\u53ef\uff0c\u4f8b\u5b50\uff1a<\/p>\n\n\n\n

CommandDef(“history”, “Show conversation history”, “Session”,  cli_only=True),<\/p>\n\n\n\n

\u5982\u679c\u53ea\u8ba9\u804a\u5929\u4ea4\u4e92\u7684\u8bdd\uff0c\u8bbe\u7f6e “gateway_only=True” \u5373\u53ef\uff08\u4e00\u822c\u4e0d\u7528\uff09\uff0c\u4f8b\u5b50\uff1a<\/p>\n\n\n\n

CommandDef(“deny”, “Deny a pending dangerous command”, “Session”,  gateway_only=True),<\/p>\n\n\n\n

\u5f53\u7136\u6bcf\u4e2askill\u4e5f\u4f1a\u53d8\u6210\u4e00\u4e2a\u659c\u6760\u6307\u4ee4\uff0c\u8fd9\u4e2a\u4e00\u822c\u4e0d\u7528\u9650\u5236\u3002<\/p>\n\n\n\n

\u628a\u5bf9\u8bdd\u8fdb\u5ea6\u5b58\u5165log\u6587\u4ef6\uff0c\u800c\u4e0d\u662f\u4ece\u804a\u5929\u4e0a\u6253\u5370\u51fa\u6765<\/strong>\uff1a<\/p>\n\n\n\n

$ hermes-agent\/gateway\/platforms\/feishu.py<\/p>\n\n\n\n

…<\/p>\n\n\n\n

        if not self._client:<\/p>\n\n\n\n

            return SendResult(success=False, error=”Not connected”)<\/p>\n\n\n\n

        chat_info = await self.get_chat_info(chat_id, None)<\/p>\n\n\n\n

        sender_profile=chat_info.get(“sender_profile”) or {“user_id”: None}<\/p>\n\n\n\n

        logger.info(f’\u53d1\u9001\uff1achat_id: {chat_id}, user_id: {sender_profile[“user_id”]}, reply_to: {repr(reply_to)}, metadata: {repr(metadata)}, content: \\n{content}’)<\/p>\n\n\n\n

        for handler in logger.handlers:<\/p>\n\n\n\n

            handler.flush()<\/p>\n\n\n\n

        formatted = self.format_message(content)<\/p>\n\n\n\n

        chunks = self.truncate_message(formatted, self.MAX_MESSAGE_LENGTH)<\/p>\n\n\n\n

…<\/p>\n\n\n\n

    async def get_chat_info(self, chat_id: str, sender_profile: Dict[str, Optional[str]]) -> Dict[str, Any]:<\/p>\n\n\n\n

        “””Return real chat metadata from Feishu when available.”””<\/p>\n\n\n\n

…<\/p>\n\n\n\n

                “type”: self._map_chat_type(raw_chat_type),<\/p>\n\n\n\n

                “raw_type”: raw_chat_type or None,<\/p>\n\n\n\n

                “sender_profile”: sender_profile,<\/p>\n\n\n\n

…  \u6240\u67094\u4e2a\u8fd9\u79cd\u5730\u65b9\uff1a<\/p>\n\n\n\n

        sender_profile = await self._resolve_sender_profile(user_id_obj)<\/p>\n\n\n\n

        chat_info = await self.get_chat_info(chat_id, sender_profile)<\/p>\n\n\n\n

…<\/p>\n\n\n\n

\u548c\u98de\u4e66\u5bf9\u8bdd\u6d88\u606f\u7684\u5c3e\u90e8\u52a0\u5165\u81ea\u5b9a\u4e49\u6309\u94ae\u4e4b\u7c7b<\/strong>\uff1a<\/p>\n\n\n\n

\u8bb0\u5f97\u5728.env\u6587\u4ef6\u4e2d\u52a0\u5165 MY_ACTION_1_LOG_FILE=\/opt\/data\/logs\/MY_ACTION_1_LOG_FILE.log \u7684\u73af\u5883\u53d8\u91cf\u503c<\/p>\n\n\n\n

\u53ea\u80fd\u4fee\u6539\u6e90\u7801\uff1a<\/p>\n\n\n\n

$ vi gateway\/platforms\/feishu.py<\/p>\n\n\n\n

…<\/p>\n\n\n\n

_APPROVAL_LABEL_MAP: Dict[str, str] = {<\/p>\n\n\n\n

    “once”: “Approved once”,<\/p>\n\n\n\n

    “session”: “Approved for session”,<\/p>\n\n\n\n

    “always”: “Approved permanently”,<\/p>\n\n\n\n

    “deny”: “Denied”,<\/p>\n\n\n\n

}<\/p>\n\n\n\n

# my_action_1: two-button interaction card \u2014 button labels and value keys<\/p>\n\n\n\n

_MY_ACTION_1_LABEL_MAP: Dict[str, str] = {<\/p>\n\n\n\n

    “btn_yes”: “\ud83d\udc4d\u8d5e”,<\/p>\n\n\n\n

    “btn_no”: “\ud83d\udc4e\u8e29”,<\/p>\n\n\n\n

}<\/p>\n\n\n\n

_MY_ACTION_1_LOG_FILE_ENV = “MY_ACTION_1_LOG_FILE”  # env var to override log path<\/p>\n\n\n\n

_FEISHU_BOT_MSG_TRACK_SIZE = 512                   # LRU size for tracking sent message IDs<\/p>\n\n\n\n

…<\/p>\n\n\n\n

        hermes_action = action_value.get(“hermes_action”) if isinstance(action_value, dict) else None<\/p>\n\n\n\n

        my_action_1 = action_value.get(“my_action_1”) if isinstance(action_value, dict) else None<\/p>\n\n\n\n

        if hermes_action:<\/p>\n\n\n\n

            return self._handle_approval_card_action(event=event, action_value=action_value, loop=loop)<\/p>\n\n\n\n

        if my_action_1:<\/p>\n\n\n\n

            self._submit_on_loop(loop, self._handle_my_action_1_card_action(event=event, action_value=action_value))<\/p>\n\n\n\n

            if P2CardActionTriggerResponse is None:<\/p>\n\n\n\n

                return None<\/p>\n\n\n\n

            response = P2CardActionTriggerResponse()<\/p>\n\n\n\n

            if CallBackCard is not None:<\/p>\n\n\n\n

                card = CallBackCard()<\/p>\n\n\n\n

                card.type = “raw”<\/p>\n\n\n\n

                card.data = self._build_my_action_1_resolved_card(btn_key=my_action_1)<\/p>\n\n\n\n

                response.card = card<\/p>\n\n\n\n

            return response<\/p>\n\n\n\n

        self._submit_on_loop(loop, self._handle_card_action_event(data))<\/p>\n\n\n\n

…<\/p>\n\n\n\n

    async def send_my_action_1(<\/p>\n\n\n\n

        self,<\/p>\n\n\n\n

        chat_id: str,<\/p>\n\n\n\n

        ai_output: str,<\/p>\n\n\n\n

        title: str = “\u8bf7\u9009\u62e9\u64cd\u4f5c”,<\/p>\n\n\n\n

        metadata: Optional[Dict[str, Any]] = None,<\/p>\n\n\n\n

    ) -> “SendResult”:<\/p>\n\n\n\n

        “””Send an interactive card with two buttons for my_action_1.<\/p>\n\n\n\n

        The buttons carry “my_action_1“ in their value dict so that<\/p>\n\n\n\n

        “_on_card_action_trigger“ can intercept them and record the<\/p>\n\n\n\n

        chat_id, timestamp, ai_output and the button choice.<\/p>\n\n\n\n

        “””<\/p>\n\n\n\n

        if not self._client:<\/p>\n\n\n\n

            from gateway.platforms.base import SendResult  # local import to avoid circular<\/p>\n\n\n\n

            return SendResult(success=False, error=”Not connected”)<\/p>\n\n\n\n

        try:<\/p>\n\n\n\n

            action_id = str(uuid.uuid4())<\/p>\n\n\n\n

            # ai_output embedded in value so the handler can recover it without a<\/p>\n\n\n\n

            # separate state store; truncated to avoid oversized card payloads.<\/p>\n\n\n\n

            ai_output_preview = ai_output[:500] + “…” if len(ai_output) > 500 else ai_output<\/p>\n\n\n\n

            def _btn(label: str, btn_key: str, btn_type: str = “default”) -> dict:<\/p>\n\n\n\n

                return {<\/p>\n\n\n\n

                    “tag”: “button”,<\/p>\n\n\n\n

                    “text”: {“tag”: “plain_text”, “content”: label},<\/p>\n\n\n\n

                    “type”: btn_type,<\/p>\n\n\n\n

                    “element_id”:   “btn_”+btn_key,<\/p>\n\n\n\n

                    “value”: {<\/p>\n\n\n\n

                        “my_action_1”: btn_key,<\/p>\n\n\n\n

                        “action_id”: action_id,<\/p>\n\n\n\n

                        “chat_id”: chat_id,<\/p>\n\n\n\n

                        “ai_output”: ai_output_preview,<\/p>\n\n\n\n

                    },<\/p>\n\n\n\n

                }<\/p>\n\n\n\n

            content_preview = ai_output[:1000] + “…” if len(ai_output) > 1000 else ai_output<\/p>\n\n\n\n

            card = {<\/p>\n\n\n\n

                “schema”: “2.0”,<\/p>\n\n\n\n

                # “config”: {“wide_screen_mode”: True},<\/p>\n\n\n\n

                # “header”: {<\/p>\n\n\n\n

                #     “title”: {“content”: title, “tag”: “plain_text”},<\/p>\n\n\n\n

                #     “template”: “blue”,<\/p>\n\n\n\n

                # },<\/p>\n\n\n\n

                “body”: {<\/p>\n\n\n\n

                    “direction”: “horizontal”,<\/p>\n\n\n\n

                    “elements”: [<\/p>\n\n\n\n

                        # {<\/p>\n\n\n\n

                        #     “tag”: “markdown”,<\/p>\n\n\n\n

                        #     “content”: content_preview,<\/p>\n\n\n\n

                        # },<\/p>\n\n\n\n

                        # {<\/p>\n\n\n\n

                        #     “tag”: “action”,<\/p>\n\n\n\n

                        #     “actions”: [<\/p>\n\n\n\n

                                _btn(_MY_ACTION_1_LABEL_MAP[“btn_yes”], “btn_yes”, “primary”),<\/p>\n\n\n\n

                                _btn(_MY_ACTION_1_LABEL_MAP[“btn_no”], “btn_no”, “danger”),<\/p>\n\n\n\n

                        #     ],<\/p>\n\n\n\n

                        # },<\/p>\n\n\n\n

                    ],<\/p>\n\n\n\n

                }<\/p>\n\n\n\n

            }<\/p>\n\n\n\n

            payload = json.dumps(card, ensure_ascii=False)<\/p>\n\n\n\n

            response = await self._feishu_send_with_retry(<\/p>\n\n\n\n

                chat_id=chat_id,<\/p>\n\n\n\n

                msg_type=”interactive”,<\/p>\n\n\n\n

                payload=payload,<\/p>\n\n\n\n

                reply_to=None,<\/p>\n\n\n\n

                metadata=metadata,<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

            return self._finalize_send_result(response, “send_my_action_1 failed”)<\/p>\n\n\n\n

        except Exception as exc:<\/p>\n\n\n\n

            logger.warning(“[Feishu] send_my_action_1 failed: %s”, exc)<\/p>\n\n\n\n

            from gateway.platforms.base import SendResult  # local import to avoid circular<\/p>\n\n\n\n

            return SendResult(success=False, error=str(exc))<\/p>\n\n\n\n

    @staticmethod<\/p>\n\n\n\n

    def _build_my_action_1_resolved_card(*, btn_key: str) -> Dict[str, Any]:<\/p>\n\n\n\n

        “””Build raw card JSON shown after a my_action_1 button is clicked.”””<\/p>\n\n\n\n

        label = _MY_ACTION_1_LABEL_MAP.get(btn_key, btn_key)<\/p>\n\n\n\n

        icon = “\u2705” if btn_key == “btn_yes” else “\u274c”<\/p>\n\n\n\n

        # color = “green” if btn_key == “btn_yes” else “red”<\/p>\n\n\n\n

        return {<\/p>\n\n\n\n

            “schema”: “2.0”,<\/p>\n\n\n\n

            # “config”: {“wide_screen_mode”: True},<\/p>\n\n\n\n

            # “header”: {<\/p>\n\n\n\n

            #     “title”: {“content”: f”{icon} {label}”, “tag”: “plain_text”},<\/p>\n\n\n\n

            #     “template”: color,<\/p>\n\n\n\n

            # },<\/p>\n\n\n\n

            “body”: {<\/p>\n\n\n\n

                “elements”: [<\/p>\n\n\n\n

                    # {<\/p>\n\n\n\n

                    #     “tag”: “button”,<\/p>\n\n\n\n

                    #     “element_id”:   “btn_”+btn_key,<\/p>\n\n\n\n

                    #     “text”: {“tag”: “plain_text”, “content”: “\u5df2\u8bb0\u5f55”},<\/p>\n\n\n\n

                    #     “disabled”: True,<\/p>\n\n\n\n

                    # },<\/p>\n\n\n\n

                    {<\/p>\n\n\n\n

                        “tag”: “markdown”,<\/p>\n\n\n\n

                        “content”: f”{icon} \u5df2\u8bb0\u5f55\u60a8\u7684\u9009\u62e9\uff1a**{label}**”,<\/p>\n\n\n\n

                    },<\/p>\n\n\n\n

                ],<\/p>\n\n\n\n

            }<\/p>\n\n\n\n

        }<\/p>\n\n\n\n

    async def _handle_my_action_1_card_action(<\/p>\n\n\n\n

        self, *, event: Any, action_value: Dict[str, Any]<\/p>\n\n\n\n

    ) -> None:<\/p>\n\n\n\n

        “””Persist my_action_1 button-click data to a JSONL log file.<\/p>\n\n\n\n

        Saved fields:<\/p>\n\n\n\n

        – “chat_id“   \u2014 the originating chat<\/p>\n\n\n\n

        – “timestamp“ \u2014 ISO-8601 UTC time of the click<\/p>\n\n\n\n

        – “ai_output“ \u2014 the AI output embedded in the card value<\/p>\n\n\n\n

        – “btn_key“   \u2014 which button was clicked (“btn_yes“ \/ “btn_no“)<\/p>\n\n\n\n

        – “action_id“ \u2014 unique ID linking click to the original card send<\/p>\n\n\n\n

        – “operator_open_id“ \u2014 open_id of the user who clicked<\/p>\n\n\n\n

        “””<\/p>\n\n\n\n

        btn_key = action_value.get(“my_action_1”, “”)<\/p>\n\n\n\n

        action_id = action_value.get(“action_id”, “”)<\/p>\n\n\n\n

        chat_id = action_value.get(“chat_id”, “”)<\/p>\n\n\n\n

        ai_output = action_value.get(“ai_output”, “”)<\/p>\n\n\n\n

        operator = getattr(event, “operator”, None)<\/p>\n\n\n\n

        operator_open_id = str(getattr(operator, “open_id”, “”) or “”)<\/p>\n\n\n\n

        timestamp = datetime.utcnow().isoformat() + “Z”<\/p>\n\n\n\n

        record = {<\/p>\n\n\n\n

            “chat_id”: chat_id,<\/p>\n\n\n\n

            “timestamp”: timestamp,<\/p>\n\n\n\n

            “ai_output”: ai_output,<\/p>\n\n\n\n

            “btn_key”: btn_key,<\/p>\n\n\n\n

            “action_id”: action_id,<\/p>\n\n\n\n

            “operator_open_id”: operator_open_id,<\/p>\n\n\n\n

        }<\/p>\n\n\n\n

        logger.info(<\/p>\n\n\n\n

            “[Feishu] my_action_1 click: chat_id=%s btn=%s action_id=%s operator=%s”,<\/p>\n\n\n\n

            chat_id,<\/p>\n\n\n\n

            btn_key,<\/p>\n\n\n\n

            action_id,<\/p>\n\n\n\n

            operator_open_id,<\/p>\n\n\n\n

        )<\/p>\n\n\n\n

        try:<\/p>\n\n\n\n

            log_path = os.environ.get(<\/p>\n\n\n\n

                _MY_ACTION_1_LOG_FILE_ENV,<\/p>\n\n\n\n

                str(Path(__file__).parent.parent.parent \/ “my_action_1_log.jsonl”),<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

            await asyncio.to_thread(<\/p>\n\n\n\n

                self._append_my_action_1_record, log_path, record<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

        except Exception as exc:<\/p>\n\n\n\n

            logger.error(“[Feishu] my_action_1 failed to persist record: %s”, exc)<\/p>\n\n\n\n

    @staticmethod<\/p>\n\n\n\n

    def _append_my_action_1_record(log_path: str, record: Dict[str, Any]) -> None:<\/p>\n\n\n\n

        “””Synchronous helper: append one JSON line to the JSONL log file.”””<\/p>\n\n\n\n

        with open(log_path, “a”, encoding=”utf-8″) as fh:<\/p>\n\n\n\n

            fh.write(json.dumps(record, ensure_ascii=False) + “\\n”)<\/p>\n\n\n\n

    async def _resolve_approval(self, approval_id: Any, choice: str, user_name: str) -> None:<\/p>\n\n\n\n

        “””Pop approval state and unblock the waiting agent thread.”””<\/p>\n\n\n\n

        state = self._approval_state.pop(approval_id, None)<\/p>\n\n\n\n

        if not state:<\/p>\n\n\n\n

            logger.debug(“[Feishu] Approval %s already resolved or unknown”, approval_id)<\/p>\n\n\n\n

            return<\/p>\n\n\n\n

        try:<\/p>\n\n\n\n

            from tools.approval import resolve_gateway_approval<\/p>\n\n\n\n

            count = resolve_gateway_approval(state[“session_key”], choice)<\/p>\n\n\n\n

            logger.info(<\/p>\n\n\n\n

                “Feishu button resolved %d approval(s) for session %s (choice=%s, user=%s)”,<\/p>\n\n\n\n

                count, state[“session_key”], choice, user_name,<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

        except Exception as exc:<\/p>\n\n\n\n

            logger.error(“Failed to resolve gateway approval from Feishu button: %s”, exc)<\/p>\n\n\n\n

…<\/p>\n\n\n\n

$ vi gateway\\platforms\\base.py<\/p>\n\n\n\n

…<\/p>\n\n\n\n

                        self._schedule_ephemeral_delete(<\/p>\n\n\n\n

                            chat_id=event.source.chat_id,<\/p>\n\n\n\n

                            message_id=result.message_id,<\/p>\n\n\n\n

                            ttl_seconds=_ephemeral_ttl,<\/p>\n\n\n\n

                        )<\/p>\n\n\n\n

                    # my_action_1: after a successful AI text reply on Feishu,<\/p>\n\n\n\n

                    # send a two-button interactive card so the user can confirm<\/p>\n\n\n\n

                    # or dismiss.  Gated on hasattr so all other platform adapters<\/p>\n\n\n\n

                    # are completely unaffected.<\/p>\n\n\n\n

                    if (<\/p>\n\n\n\n

                        result.success<\/p>\n\n\n\n

                        and text_content<\/p>\n\n\n\n

                        and hasattr(self, “send_my_action_1”)<\/p>\n\n\n\n

                        and getattr(event.source, “platform”, None) == Platform.FEISHU<\/p>\n\n\n\n

                    ):<\/p>\n\n\n\n

                        try:<\/p>\n\n\n\n

                            await self.send_my_action_1(<\/p>\n\n\n\n

                                chat_id=event.source.chat_id,<\/p>\n\n\n\n

                                ai_output=text_content,<\/p>\n\n\n\n

                                metadata=_thread_metadata,<\/p>\n\n\n\n

                            )<\/p>\n\n\n\n

                        except Exception as _ma1_err:<\/p>\n\n\n\n

                            logger.warning(<\/p>\n\n\n\n

                                “[%s] send_my_action_1 failed (non-fatal): %s”,<\/p>\n\n\n\n

                                self.name, _ma1_err,<\/p>\n\n\n\n

                            )<\/p>\n\n\n\n

                # Human-like pacing delay between text and media<\/p>\n\n\n\n

                human_delay = self._get_human_delay()<\/p>\n\n\n\n

…<\/p>\n\n\n\n

\u56de\u590d\u5361\u7247\u65f6\uff0c\u4e0d\u518d\u751f\u6210\u53e6\u4e00\u4e2a\u6587\u672c\u56de\u590d\uff1a<\/strong><\/p>\n\n\n\n

$ gateway\/platforms\/feishu.py<\/p>\n\n\n\n

def _build_outbound_payload(self, content: str) -> tuple[str, str]:<\/p>\n\n\n\n

    # Detect interactive card JSON:<\/p>\n\n\n\n

    # if the content looks like a Card 2.0 JSON object, send it directly<\/p>\n\n\n\n

    # as msg_type=interactive so the LLM can return a card as its final<\/p>\n\n\n\n

    # reply without needing a separate REST call.<\/p>\n\n\n\n

    stripped = content.strip()<\/p>\n\n\n\n

    if stripped.startswith(“{“):<\/p>\n\n\n\n

        try:<\/p>\n\n\n\n

            parsed = json.loads(stripped)<\/p>\n\n\n\n

            if isinstance(parsed, dict):<\/p>\n\n\n\n

                # Card 2.0: {“schema”: “2.0”, “body”: {…}, …}<\/p>\n\n\n\n

                if parsed.get(“schema”) == “2.0” and “body” in parsed:<\/p>\n\n\n\n

                    return “interactive”, json.dumps(parsed, ensure_ascii=False)<\/p>\n\n\n\n

                # Wrapped: {“msg_type”: “interactive”, “content”: {…}}<\/p>\n\n\n\n

                if parsed.get(“msg_type”) == “interactive” and “content” in parsed:<\/p>\n\n\n\n

                    inner = parsed[“content”]<\/p>\n\n\n\n

                    if isinstance(inner, str):<\/p>\n\n\n\n

                        return “interactive”, inner<\/p>\n\n\n\n

                    return “interactive”, json.dumps(inner, ensure_ascii=False)<\/p>\n\n\n\n

        except (json.JSONDecodeError, ValueError):<\/p>\n\n\n\n

            pass<\/p>\n\n\n\n

    # Feishu post-type ‘md’ elements do not render markdown tables;<\/p>\n\n\n\n

    # sending table content as post causes the message to appear blank<\/p>\n\n\n\n

    # on the client. Force plain text for anything that looks like a<\/p>\n\n\n\n

    # markdown table.<\/p>\n\n\n\n

    if _MARKDOWN_TABLE_RE.search(content):<\/p>\n\n\n\n

        text_payload = {“text”: content}<\/p>\n\n\n\n

        return “text”, json.dumps(text_payload, ensure_ascii=False)<\/p>\n\n\n\n

    if _MARKDOWN_HINT_RE.search(content):<\/p>\n\n\n\n

        return “post”, _build_markdown_post_payload(content)<\/p>\n\n\n\n

    text_payload = {“text”: content}<\/p>\n\n\n\n

    return “text”, json.dumps(text_payload, ensure_ascii=False)<\/p>\n\n\n\n

\u589e\u52a0plugin\u751f\u6210\u56fe\u7247\uff1a<\/strong><\/p>\n\n\n\n

$ cd plugins\/image_gen<\/p>\n\n\n\n

$ mkdir gemini-imagen<\/p>\n\n\n\n

$ cd  gemini-imagen<\/p>\n\n\n\n

$ vi __init__.py<\/p>\n\n\n\n

from __future__ import annotations<\/p>\n\n\n\n

import os<\/p>\n\n\n\n

import sys<\/p>\n\n\n\n

import base64<\/p>\n\n\n\n

import logging<\/p>\n\n\n\n

from agent.image_gen_provider import (<\/p>\n\n\n\n

    ImageGenProvider, error_response, success_response, save_b64_image<\/p>\n\n\n\n

)<\/p>\n\n\n\n

logger = logging.getLogger(__name__)<\/p>\n\n\n\n

SA_JSON = ‘\/opt\/data\/common_config\/data-collect-11111111.json’<\/p>\n\n\n\n

GCP_PROJECT = ‘data-collect’<\/p>\n\n\n\n

GCP_LOCATION = ‘us-central1’<\/p>\n\n\n\n

DEFAULT_MODEL = ‘imagen-3.0-generate-002’<\/p>\n\n\n\n

ASPECT_RATIO_MAP = {<\/p>\n\n\n\n

    ‘landscape’: ’16:9′,<\/p>\n\n\n\n

    ‘portrait’:  ‘9:16’,<\/p>\n\n\n\n

    ‘square’:    ‘1:1’,<\/p>\n\n\n\n

}<\/p>\n\n\n\n

class GeminiImagenProvider(ImageGenProvider):<\/p>\n\n\n\n

    @property<\/p>\n\n\n\n

    def name(self) -> str:<\/p>\n\n\n\n

        return “gemini-imagen”<\/p>\n\n\n\n

    @property<\/p>\n\n\n\n

    def display_name(self) -> str:<\/p>\n\n\n\n

        return “Google Imagen (Vertex AI \/ Service Account)”<\/p>\n\n\n\n

    def is_available(self) -> bool:<\/p>\n\n\n\n

        if not os.path.exists(SA_JSON):<\/p>\n\n\n\n

            return False<\/p>\n\n\n\n

        try:<\/p>\n\n\n\n

            sys.path.insert(0, ‘\/opt\/data\/python_packages’)<\/p>\n\n\n\n

            import google.genai<\/p>\n\n\n\n

            from google.oauth2 import service_account<\/p>\n\n\n\n

        except ImportError:<\/p>\n\n\n\n

            return False<\/p>\n\n\n\n

        return True<\/p>\n\n\n\n

    def list_models(self):<\/p>\n\n\n\n

        return [<\/p>\n\n\n\n

            {“id”: “imagen-3.0-generate-002”,      “label”: “Imagen 3.0”,       “note”: “recommended”},<\/p>\n\n\n\n

            {“id”: “imagen-4.0-generate-001”,       “label”: “Imagen 4.0”,       “note”: “high quality”},<\/p>\n\n\n\n

            {“id”: “imagen-4.0-fast-generate-001”,  “label”: “Imagen 4.0 Fast”,  “note”: “fast”},<\/p>\n\n\n\n

            {“id”: “imagen-4.0-ultra-generate-001”, “label”: “Imagen 4.0 Ultra”, “note”: “best quality”},<\/p>\n\n\n\n

        ]<\/p>\n\n\n\n

    def generate(self, prompt: str, **kwargs) -> dict:<\/p>\n\n\n\n

        try:<\/p>\n\n\n\n

            sys.path.insert(0, ‘\/opt\/data\/python_packages’)<\/p>\n\n\n\n

            os.environ[‘GOOGLE_GENAI_USE_VERTEXAI’] = ‘true’<\/p>\n\n\n\n

            from google import genai<\/p>\n\n\n\n

            from google.genai import types<\/p>\n\n\n\n

            from google.oauth2 import service_account<\/p>\n\n\n\n

            credentials = service_account.Credentials.from_service_account_file(<\/p>\n\n\n\n

                SA_JSON,<\/p>\n\n\n\n

                scopes=[‘https:\/\/www.googleapis.com\/auth\/cloud-platform<\/a>‘]<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

            client = genai.Client(<\/p>\n\n\n\n

                vertexai=True,<\/p>\n\n\n\n

                project=GCP_PROJECT,<\/p>\n\n\n\n

                location=GCP_LOCATION,<\/p>\n\n\n\n

                credentials=credentials,<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

            model_id = kwargs.get(“model”) or DEFAULT_MODEL<\/p>\n\n\n\n

            raw_ratio = kwargs.get(“aspect_ratio”, “landscape”)<\/p>\n\n\n\n

            aspect_ratio = ASPECT_RATIO_MAP.get(raw_ratio, raw_ratio)<\/p>\n\n\n\n

            response = client.models.generate_images(<\/p>\n\n\n\n

                model=model_id,<\/p>\n\n\n\n

                prompt=prompt,<\/p>\n\n\n\n

                config=types.GenerateImagesConfig(<\/p>\n\n\n\n

                    number_of_images=1,<\/p>\n\n\n\n

                    aspect_ratio=aspect_ratio,<\/p>\n\n\n\n

                ),<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

            img_bytes = None<\/p>\n\n\n\n

            for img in response.generated_images:<\/p>\n\n\n\n

                img_bytes = img.image.image_bytes<\/p>\n\n\n\n

                break<\/p>\n\n\n\n

            client.close()<\/p>\n\n\n\n

            if img_bytes is None:<\/p>\n\n\n\n

                return error_response(<\/p>\n\n\n\n

                    error=”Model returned no image.”,<\/p>\n\n\n\n

                    provider=self.name,<\/p>\n\n\n\n

                    prompt=prompt,<\/p>\n\n\n\n

                )<\/p>\n\n\n\n

            b64 = base64.b64encode(img_bytes).decode()<\/p>\n\n\n\n

            path = save_b64_image(b64, prefix=”gemini”, extension=”png”)<\/p>\n\n\n\n

            return success_response(<\/p>\n\n\n\n

                image=str(path),<\/p>\n\n\n\n

                model=model_id,<\/p>\n\n\n\n

                prompt=prompt,<\/p>\n\n\n\n

                aspect_ratio=aspect_ratio,<\/p>\n\n\n\n

                provider=self.name,<\/p>\n\n\n\n

            )<\/p>\n\n\n\n

        except Exception as e:<\/p>\n\n\n\n

            logger.exception(“Gemini image generation failed”)<\/p>\n\n\n\n

            return error_response(error=str(e), provider=self.name, prompt=prompt)<\/p>\n\n\n\n

def register(ctx):<\/p>\n\n\n\n

    ctx.register_image_gen_provider(GeminiImagenProvider())<\/p>\n\n\n\n

$ vi plugin.yaml<\/p>\n\n\n\n

name: gemini-imagen<\/p>\n\n\n\n

version: 1.0.0<\/p>\n\n\n\n

description: “Google Gemini Imagen 3 image generation backend. Saves generated images to $HERMES_HOME\/cache\/images\/.”<\/p>\n\n\n\n

author: custom<\/p>\n\n\n\n

kind: backend<\/p>\n\n\n\n

$ vi $HERMES_HOME\/.env<\/p>\n\n\n\n

…<\/p>\n\n\n\n

GOOGLE_GENAI_USE_VERTEXAI=true     # \u8868\u793a\u4f7f\u7528\u4f01\u4e1a\u7248<\/p>\n\n\n\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

hermes agent\u5b8c\u5168\u53ef\u4ee5\u4e0d\u4ece\u516c\u7f51\u8bbf\u95ee\u5b83\uff0c\u4f46\u662f\u5b83\u5fc5\u987b\u80fd\u8bbf\u95ee\u516c\u7f51\u3002 hermes agent\u7684Docker …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[443],"tags":[],"class_list":["post-1209","post","type-post","status-publish","format-standard","hentry","category-443"],"views":270,"_links":{"self":[{"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/1209","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1209"}],"version-history":[{"count":2,"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/1209\/revisions"}],"predecessor-version":[{"id":1212,"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/1209\/revisions\/1212"}],"wp:attachment":[{"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1209"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1209"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.max-shu.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1209"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}