中文 EN

使用指南

使用指南

模型接入

AgentKit 使用 ChatModel 抽象模型接口。首版内置：

  • MockChatModel：本地离线模型，用于演示和测试。
  • OpenAICompatibleModel：兼容 OpenAI Chat Completions 协议的 HTTP 客户端。
  • DeepSeekModel：DeepSeek 模型客户端，默认使用 OpenAI-compatible 接口 https://api.deepseek.com 和 deepseek-v4-flash。

示例程序支持三种 provider：mock、openai、deepseek。配置文件 agentkit.local.json 中把 provider 设置为 deepseek 后，只需要填写 DeepSeek API Key 即可使用真实模型；也可以通过 DEEPSEEK_API_KEY、DEEPSEEK_BASE_URL、DEEPSEEK_MODEL 环境变量配置。

工具调用

业务功能通过 AgentTool 或 FunctionTool 注册到 ToolRegistry。工具包含名称、说明、JSON Schema、权限和执行函数。

工具权限包括：

  • ReadOnly
  • Write
  • Destructive
  • ExternalNetwork
  • FileSystem
  • SystemCommand

涉及写入、文件系统或更高风险操作时，应通过审批弹窗确认。

Trace 追踪

每次工具调用会生成 ToolCallTrace，用于展示工具名称、状态、权限、输入、输出、错误和耗时。ToolCallTraceView 可直接用于产品调试界面。

工作流编排

StateGraph 使用 QJsonObject 作为状态对象。节点读取状态并返回局部更新，边和条件边决定下一步执行位置。

适合实现：

  • 多步骤任务。
  • 条件路由。
  • 循环直到完成。
  • 人工审核。
  • 工具节点和模型节点组合。