请求方式与超时时间的功能概述
请求方式的概念与默认配置
海王出海SCRM的请求方式指翻译引擎API调用时使用的HTTP方法，所有翻译引擎统一采用POST请求方式发送翻译请求。POST方法能够承载较长的待翻译文本内容，适合翻译场景中消息长度不固定的实际需求。当前版本不支持切换为GET或其他请求方法，POST是唯一选项。绝大多数翻译引擎API均要求使用POST方法，因此默认配置已满足所有已接入引擎的要求。
超时时间的定义与默认值
超时时间指海王出海SCRM向翻译引擎发送请求后等待响应返回的最大时长，超过此时长系统自动中断请求并返回超时错误。默认超时时间为30秒，这已能覆盖绝大多数正常翻译请求的响应周期。DeepL和Google Translate的常规翻译响应时间通常在1到3秒之间，Azure Translator通常在2到4秒之间，GPT因模型复杂度响应时间可能在5到15秒之间。
超时时间的调整对翻译体验的影响
缩短超时时间可以更快发现服务异常，但网络波动时可能因短暂延迟导致超时误判。延长超时时间可以增加翻译请求的成功率，但过长可能导致客服等待时间增加，影响对话的实时性体验。建议在默认30秒基础上根据网络质量和业务对稳定性的要求进行微调。
请求方式的配置与确认
请求方式的查看入口
管理员登录海王出海SCRM后台后在翻译设置页面中找到引擎高级配置或API设置区域，该区域显示当前使用的请求方法。POST为唯一可用选项且不可修改，界面中的请求方式字段仅用于信息确认和查看。配置界面中不提供请求方式的切换选项或下拉菜单。
请求方式与引擎兼容性的确认
各主流翻译引擎的API文档明确要求使用POST方法提交翻译请求，海王出海SCRM的默认POST配置与所有已接入引擎完全兼容。使用POST方法可以传递更长的待翻译文本和更多的请求参数，无需担心URL长度限制导致的截断问题。用户无需对请求方式做任何配置调整，它已被锁定为正确的值。
请求方式相关的错误排查
如果请求方式与引擎要求不匹配会返回“Method Not Allowed”或“请求方法不支持”的错误。海王出海SCRM当前使用正确的POST方法通常不会出现此类错误。若出现请求方式相关错误，需检查是否存在网络中间件修改了请求方法或代理服务器配置异常。
超时时间的配置路径与操作方法
超时时间的设置入口
管理员登录后台后进入翻译设置的引擎配置区域，在高级选项或超时设置子页面中找到超时时间配置字段。该字段以秒为单位，默认值为30。输入框支持手动键入数字，范围限制在5到120秒之间，超出范围的数值会被系统自动修正为边界值。
超时时间的调整步骤
在超时时间输入框中键入期望的数值，单位为秒，例如键入20表示20秒超时。输入完成后点击保存或应用按钮使新超时时间生效。调整后无需重启软件或重新登录，后续翻译请求即按新超时时间执行。建议每次调整以5秒为步长逐步优化找到最适合业务环境的配置值。
按引擎独立配置超时时间
海王出海SCRM允许为DeepL、Google Translate、Azure Translator和OpenAI分别独立配置超时时间，各引擎的超时设置互不影响独立生效。GPT引擎因响应时间较长建议配置为45到60秒，其他引擎保持在20到30秒即可。按引擎独立配置让企业能够根据各引擎的实际响应特征精细优化超时策略。
超时时间的合理配置建议
不同引擎的推荐超时值
DeepL引擎推荐超时时间为20秒，其响应速度稳定通常在2秒内返回结果，20秒已覆盖正常波动。Google Translate推荐超时时间为25秒，其API响应速度同样稳定且偶尔有轻微延迟。Azure Translator推荐超时时间为30秒，企业级服务偶有长尾请求，30秒能保证较高成功率。OpenAI GPT推荐超时时间为60秒，因为大语言模型生成翻译需要更多处理时间。
网络环境对超时时间的影响
企业网络质量较好且与翻译引擎服务器之间的延迟较低时，可将超时时间缩短至15到20秒以更快感知服务异常。网络质量不稳定或使用跨国代理时，建议将超时时间延长至45到60秒以避免因网络波动导致的频繁超时。跨境网络环境下建议优先使用Azure Translator或Google Translate，它们在全球部署了更多服务节点。
根据业务场景调整超时时间
实时客服场景中客服与客户正在实时对话，翻译延迟直接影响客户等待时间，建议将超时时间设为20秒以内。异步处理场景中批量翻译任务对实时性要求不高，可适当延长超时至45秒提升任务成功率。业务高峰期中引擎响应可能变慢，可临时增加超时时间保证翻译服务的可用性。
超时触发后的处理机制与错误提示
超时触发时返回的错误信息
当翻译请求在设定的超时时间内未收到引擎响应时，海王出海SCRM返回“请求超时，请检查网络连接或尝试稍后重试”的错误提示。错误提示中不包含具体超时时间值。超时消息显示在翻译结果的对应位置，客服在聚合面板中可以看到明确的状态提示。
超时后的自动重试机制
单个消息翻译超时后系统不会自动重试，客服可手动点击重试按钮重新发起翻译请求。批量翻译任务中的单条消息超时不阻塞其他消息处理，超时消息标记为失败并在任务报告中列出供后续手动处理。
连续超时时的降级处理方案
当同一引擎连续多次超时且影响正常翻译时，系统自动标记该引擎为亚健康状态并降低其调度权重。后续翻译请求优先路由到其他健康的引擎，待亚健康引擎恢复后自动恢复正常调度。降级处理方案确保单个引擎超时不至于导致整体翻译服务不可用。
超时时间配置后的验证与监控
超时配置生效的验证方法
配置新超时时间后建议发送一条长度适中的测试消息观察翻译是否正常返回，正常返回说明配置生效。若要测试超时功能是否生效，可将超时时间临时调整为1秒，发送翻译请求后应触发超时错误，测试完成后将超时时间恢复为正常值。
超时频率的监控与统计
管理员可在翻译用量报表的性能监控板块查看各引擎的超时频率统计，按日展示超时次数和超时率百分比。超时率持续高于5%时建议检查网络质量或适当延长该引擎的超时时间。超时统计帮助管理员主动发现服务异常或网络劣化趋势。
超时配置的定期审查与优化
建议每季度审查一次超时配置，根据各引擎的近期响应时间和超时频率微调超时值。新接入的引擎在初期可能响应不稳定，可在接入后的前两周设置较长的超时时间观察其表现，稳定后再逐步调整为最优值。