Hermes Agent线程池优化需据负载选择配置方式：一、硬编码调整max_workers；二、CLI配置动态注入；三、分层线程池按任务类型路由；四、运行时动态扩缩容；五、CPU亲和性绑定提升缓存命中率。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行Hermes Agent时发现工具调用响应迟缓、CPU利用率不均衡或并发任务排队严重，则很可能是线程池配置未适配当前工作负载。以下是针对Hermes Agent线程池的具体配置方法与优化技巧：
一、修改核心线程池初始化参数
该方法直接调整environments/agent_loop.py中线程池的容量，适用于固定高并发场景。通过显式设定max_workers值，可控制最大并行工具调用数。
1、打开文件environments/agent_loop.py，定位到_tool_executor = concurrent.futures.ThreadPoolExecutor(max_workers=128)这一行。
2、根据实际CPU核心数计算推荐值：若系统为8核CPU，建议设为17（即8×2+1）；若需支持89个并行评估任务（如terminalbench2_env.py所示），则必须设为≥89。
3、保存文件后重启Agent服务以使配置生效。
二、基于CLI配置文件动态注入
该方法利用cli-config.yaml实现运行时参数解耦，避免硬编码修改源码，适合多环境部署场景。
1、在cli-config.yaml中新增或修改tool_thread_pool_size字段，例如：tool_thread_pool_size: 32。
2、在environments/agent_loop.py中读取该配置：使用config.get("tool_thread_pool_size", 128)替代固定数值。
3、确保CLI配置加载逻辑早于线程池初始化，否则参数不会被采纳。
三、按任务类型启用分层线程池
该方法为I/O密集型与CPU密集型任务分别分配独立线程池，规避GIL限制并防止任务相互阻塞。
1、在batch_runner.py中保留原有多进程池用于纯CPU任务（如向量化计算）。
2、在environments/agent_loop.py中新增一个专用于API调用的线程池：_api_executor = ThreadPoolExecutor(max_workers=64)。
3、工具调度器需识别任务类型标签（如"cpu_bound"或"io_bound"），并路由至对应执行器。
四、运行时动态扩缩容
该方法依据实时任务队列长度自动调整线程池大小，适用于负载波动剧烈的生产环境。
1、在environments/hermes_base_env.py中引入自适应逻辑：监听pending_task_count指标。
2、当待处理任务数持续超过阈值（如50）达30秒，调用_tool_executor._max_workers = min(_tool_executor._max_workers * 2, 256)。
3、当空闲时间超过120秒且当前工作线程数＞基础值，触发收缩：调用shutdown(wait=False)后重建线程池，避免残留线程占用资源。
五、绑定CPU亲和性提升缓存局部性
该方法将特定线程池绑定至指定CPU核心组，减少上下文切换开销并增强L3缓存命中率。
1、安装psutil库：pip install psutil。
2、在environments/agent_loop.py初始化线程池前，添加核心绑定逻辑：psutil.Process().cpu_affinity([0, 1, 2, 3])。
3、仅对专用线程池（如batch_runner.py中的多进程池）启用此设置，主线程池保持默认调度。
