mirror of https://github.com/musistudio/claude-code-router.git synced 2026-01-29 22:02:05 +00:00

Files

musistudio 160594a8d6 init doc

2025-12-27 07:58:01 +08:00

2.3 KiB

Raw Blame History

id, title, sidebar_position

id	title	sidebar_position
advanced/agents	Agent 系统	2

Agent 系统

使用 Agent 系统扩展功能。

什么是 Agent？

Agent 是可插拔的功能模块，可以：

检测是否应处理请求
修改请求
提供自定义工具

内置 Agent

Image Agent

通过检测请求中的图像 URL 或文件路径来处理图像相关任务。

当检测到图像相关内容时，Image Agent 会：

标记请求需要图像处理
添加图像分析工具到请求中
拦截工具调用事件
执行图像分析并返回结果

Agent 配置

Agent 在服务器配置中配置并自动加载。

启用 Image Agent

Image Agent 内置于服务器中，无需额外配置。当请求包含图像内容时自动激活。

强制使用 Image Agent

如果您的模型不支持工具调用，可以在配置中设置 config.forceUseImageAgent 为 true：

{
  "Router": {
    "image": "gemini,gemini-2.5-pro"
  },
  "forceUseImageAgent": true
}

Agent 工具调用流程

检测阶段：在 preHandler 钩子中检测并标记 agents
准备阶段：将 agent 工具添加到请求中
拦截阶段：在 onSend 钩子中拦截工具调用事件
执行阶段：执行 agent 工具并发起新的 LLM 请求
返回阶段：将结果流式返回

Agent 类型定义

interface IAgent {
  name: string;
  shouldHandle: (req: any, config: any) => boolean;
  reqHandler: (req: any, config: any) => void;
  tools: Map<string, ITool>;
}

interface ITool {
  name: string;
  description: string;
  input_schema: object;
  handler: (args: any, context: any) => Promise<any>;
}

创建自定义 Agent

自定义 Agent 支持正在开发中！

使用示例

图像分析请求

当您发送包含图像的请求时：

请分析这张图片：/path/to/image.png

Image Agent 将：

检测到图像路径
添加图像分析工具
调用配置的图像处理模型
返回分析结果

路由到支持图像的模型

在配置中指定用于图像任务的模型：

{
  "Router": {
    "image": "gemini,gemini-2.5-pro"
  }
}

下一步

预设 - 使用预定义配置
自定义路由器 - 编写自定义路由逻辑

2.3 KiB Raw Blame History Unescape Escape