oclaw/runtime/chat/agent_errors.py
oliver 4a23b715a2 重构仓库目录为统一的 runtime 分层并清理历史 openclaw 残留。
本次迁移将网关/通道/工具/技能/脚本与协议资源集中到新结构,统一路径常量与脚本转发机制,减少顶层噪音并保证运行与测试行为一致。

Made-with: Cursor
2026-04-25 01:24:23 +08:00

69 lines
2.6 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

from __future__ import annotations
"""Agent 错误处理模块。
把 `Agent` 内的错误格式化逻辑下沉到此处,方便 manager/specialist 复用。
"""
from typing import Any
from oclaw.prompts import render_prompt
def format_ollama_failure_banner(*, lang: str, exc: BaseException) -> str:
prompt_id = "fallback/ollama_failure.en.md" if (lang or "zh").startswith("en") else "fallback/ollama_failure.zh.md"
return render_prompt(
prompt_id,
variables={"error_type": type(exc).__name__, "error_message": str(exc)},
strict=True,
)
def format_openai_transport_error(*, lang: str, exc: BaseException) -> str:
blob = str(exc).lower()
oversized_tool = ("30000" in blob or "input length" in blob) and ("range" in blob or "length" in blob)
gemini_sig = "thought_signature" in blob
if (lang or "zh").startswith("en"):
if oversized_tool:
return render_prompt(
"fallback/openai_transport_oversized.en.md",
variables={"error_type": type(exc).__name__, "error_message": str(exc)},
strict=True,
)
tail = (
"\n\n_Gemini 3 with tools: the API requires echoing `thought_signature` from each tool use in chat history. "
"If this persists, update the app or use a model/SDK path that preserves provider-specific tool fields._"
if gemini_sig
else ""
)
return render_prompt(
"fallback/openai_transport_error.en.md",
variables={"error_type": type(exc).__name__, "error_message": str(exc), "extra_tail": tail},
strict=True,
)
if oversized_tool:
return render_prompt(
"fallback/openai_transport_oversized.zh.md",
variables={"error_type": type(exc).__name__, "error_message": str(exc)},
strict=True,
)
tail = (
"\n\n(**Gemini 3 + 工具调用**:接口要求把模型返回的 **thought_signature** 随该次 `tool_calls` 一并写回对话历史;"
"首轮能跑工具、第二轮 400 多为丢失该字段。若已更新本应用仍报错,请确认代理/OpenAI 兼容层是否透传该字段。)"
if gemini_sig
else ""
)
return render_prompt(
"fallback/openai_transport_error.zh.md",
variables={"error_type": type(exc).__name__, "error_message": str(exc), "extra_tail": tail},
strict=True,
)
def safe_str(e: Any) -> str:
try:
return str(e)
except Exception:
return repr(e)
__all__ = ["format_ollama_failure_banner", "format_openai_transport_error", "safe_str"]