工具（Tools）¶
注册 LLM 可调用的工具。工具是插件最主要的能力形态：模型看到 ToolDef 的说明后决定是否调用，调用时执行你的 ToolHandler。
ContentBlock¶
type ContentBlock struct { Type string `json:"type"` Text string `json:"text,omitempty"` ImageURL *ImageURL `json:"image_url,omitempty"` AudioURL *AudioURL `jso …
ContentBlock 是多模态内容块（OpenAI 格式：text/image_url/audio_url）。 插件工具返回结果时可用 PluginSDK.SetToolBlocks 注入，让下一轮 LLM 请求在 tool message 的 content 数组里带上图片/音频，实现"模型看图/听音频"。
plugin.go:1235
PluginSDK.RegisterTool¶
RegisterTool registers a tool that the LLM can call.
示例插件里的真实用法
| 插件 | 位置 | 代码 |
|---|---|---|
feiyu_voice |
example/feiyu_voice/plugin.go:83 |
s.RegisterTool(p.name+"_say", sdk.ToolDef{ |
rtvoice |
example/rtvoice/plugin.go:225 |
s.RegisterTool(p.name+"_say", sdk.ToolDef{ |
plugin.go:788
ToolCall¶
type ToolCall struct { ID string `json:"id"` Name string `json:"name"` Plugin string `json:"plugin,omitempty …
ToolCall represents a model's request to call a tool.
plugin.go:356
ToolDef¶
type ToolDef struct { Name string `json:"name"` Plugin string `json:"plugin,omitempty"` Description string …
ToolDef describes a tool that the plugin exposes.
plugin.go:408
ToolHandler¶
ToolHandler is a function that handles a tool call.
plugin.go:21
ToolResult¶
type ToolResult struct { CallID string `json:"call_id"` Name string `json:"name"` Plugin string `json:"plugin,omitempty"` Success bool `json:"suc …
ToolResult represents the result of a tool call.
plugin.go:364