工具调用解析器

Twinkle 的模板系统包含模块化的工具调用解析框架，用于训练具有函数调用能力的模型。

架构

ToolCallRegistry
├── HermesQwenParser  — Hermes/Qwen 风格 <tool_call>...</tool_call>
├── ReActParser       — ReAct Thought/Action/Observation
├── ClineParser       — Cline XML 工具调用
└── VCPParser         — VCP 协议

ToolCallParser 接口

from twinkle.template.tools import ToolCallParser

class ToolCallParser(ABC):
    name: str = ''

    def detect(self, text: str) -> bool:
        """检查文本是否包含此格式的标记"""

    def parse(self, text: str) -> List[Dict[str, Any]]:
        """提取 OpenAI 格式的工具调用"""

    def clean(self, text: str) -> str:
        """去除标记，返回纯内容"""

ToolCallRegistry

注册表自动发现解析器并路由检测：

from twinkle.template.tools import ToolCallRegistry

# 检测补全使用了哪种格式
parser = ToolCallRegistry.detect_first(completion_text)
if parser:
    tool_calls = parser.parse(completion_text)

内置解析器

解析器	格式说明
HermesQwenParser	<tool_call>{"name": "...", "arguments": {...}}</tool_call>
ReActParser	Thought/Action/Action Input/Observation
ClineParser	Cline XML 结构化参数
VCPParser	Visual Code Protocol