跳到主要内容

术语表

本页用于统一 AI4J 文档中的核心术语，避免同一概念在不同专题里被混淆。

A​

ACP​

ACP 是 Coding Agent 的宿主集成协议，用于 IDE、桌面应用或自定义前端与 ai4j-cli acp 通过结构化 JSON-RPC 通信。

它不是模型协议，也不是 MCP。

对应文档：

Agent​

AI4J 中的 Agent 指一套围绕模型、运行时、工具、记忆和编排构建的智能体框架。

对应文档：

AiService​

AI4J 的统一服务工厂，用于按 PlatformType 获取 Chat、Responses、Embedding、Audio、Image、Realtime 等服务接口。

对应文档：

C​

Chat​

指 Chat Completions 风格的消息式模型接口。

在 AI4J 中通常对应：

  • IChatService
  • ChatCompletion
  • ChatCompletionResponse

CodeAct​

AI4J Agent 中的代码驱动运行时。

适合：

  • 先生成代码
  • 再通过代码多次调用工具
  • 处理复杂结构化任务

对应文档：

Coding Agent​

AI4J 面向本地代码仓交付的一套工程化入口，包含：

  • CLI
  • TUI
  • ACP
  • 会话、命令、工具、Skills、MCP 集成

它不是通用 Agent 框架的同义词，而是偏“本地编码交互”的产品层。

对应文档：

F​

Flowgram​

AI4J 提供的低代码工作流编排接入方向，面向流程图式节点运行、后端任务执行、节点扩展。

对应文档：

Function Tool​

本地 Java 函数工具，通过注解或注册方式暴露给模型调用。

它和 MCP Tool 的区别在于：

  • Function Tool 通常直接存在于本地应用内部
  • MCP Tool 来自 MCP Server

G​

Gateway​

在 MCP 语境里通常指 McpGateway，用于统一管理多个 MCP Client、聚合工具并做路由治理。

对应文档：

M​

MCP​

Model Context Protocol，模型接外部能力的标准协议层。

在 AI4J 中覆盖：

  • MCP Client
  • MCP Gateway
  • MCP Server

对应文档：

Memory​

Agent 或 Coding Agent 在持续会话中的上下文记忆机制。

通常包括：

  • 历史消息
  • 工具调用记录
  • 压缩摘要
  • checkpoint

Model Client​

Agent 层的模型适配接口，用于把运行时构造的 AgentPrompt 转成具体模型请求。

常见实现：

  • ChatModelClient
  • ResponsesModelClient

P​

PlatformType​

AI4J 中的平台枚举，用于声明你要调用哪家模型平台。

例如：

  • OPENAI
  • DOUBAO
  • DASHSCOPE
  • OLLAMA

Profile​

在 Coding Agent 中，provider profile 指一组可复用的模型配置组合，例如：

  • provider
  • protocol
  • model
  • baseUrl
  • apiKey 来源

对应文档：

Prompt Assembly​

在 Coding Agent 语境里，指最终送给模型的上下文是如何由：

  • systemPrompt
  • workspace 指令
  • instructions
  • session memory
  • 当前输入
  • tool schemas

共同组成的。

对应文档：

R​

ReAct​

AI4J Agent 的默认通用运行时，适合：

  • 文本任务
  • 多轮思考
  • 按需调用工具

对应文档：

Responses​

指事件化响应模型接口。

在 AI4J 中通常对应：

  • IResponsesService
  • ResponseRequest
  • Response
  • ResponseSseListener

它和 Chat 的差别不只是接口名不同，更在于事件模型更强。

S​

Session​

持续会话实例。

在 Coding Agent 中，session 通常包含：

  • 当前上下文
  • 历史事件
  • 分支关系
  • 内存压缩信息
  • 进程状态

Skill​

Coding Agent 中的一类可发现说明文件，通常以 SKILL.md 形式存在。

它不是工具协议，而是供模型按需读取和复用的任务说明、模板或工作流指引。

对应文档：

StateGraph​

Agent Workflow 中的状态图编排能力，适合分支、循环、条件路由。

对应文档：

Stream​

指模型响应以增量方式到达，而不是一次性整包返回。

要注意：

  • 流式事件不等于 token
  • 不同平台的 chunk 粒度不同

T​

Tool Registry​

用于决定“暴露给模型哪些工具”的注册层。

它和 ToolExecutor 不同：

  • ToolRegistry 决定可见性
  • ToolExecutor 决定执行方式

Trace​

指 Agent 或 Coding Agent 的过程观测能力。

通常用于记录：

  • 模型调用
  • 工具调用
  • 步骤耗时
  • 错误与回退

对应文档：