基础概念与术语

Spring AI 中最核心的几个概念

ChatClient

Spring AI 的核心 API，用于与 AI 模型交互。

1
2
3
4
5
6
7
8
9
// 简洁方式
chatClient.prompt().user("Hello").call().content();

// 链式调用（推荐）
chatClient.prompt()
    .system("System prompt")
    .user("User message")
    .call()
    .content();

Prompt

提示词，包含 system（系统指令）+ user（用户输入）。

1
2
3
4
5
6
7
8
9
10
// 方式1: 字符串
prompt("Hello")

// 方式2: Builder（推荐）
Prompt prompt = new Prompt(
    List.of(
        new Message("You are a helpful assistant", Role.SYSTEM),
        new Message("What is Java?", Role.USER)
    )
);

Message & Role

Role作用
SYSTEM系统级指令，定义 AI 行为角色
USER用户输入
ASSISTANTAI 响应

ChatOptions

模型参数配置（temperature、topP、maxTokens 等）。

1
2
3
4
5
6
7
8
chatClient.prompt()
    .user("写一首诗")
    .options(ChatOptionsBuilder.builder()
        .withTemperature(0.8)
        .withMaxTokens(500)
        .build())
    .call()
    .content();

OutputConverter

将 AI 响应映射为 Java 对象。

1
2
3
4
5
6
record Answer(String result) {}

Answer answer = chatClient.prompt()
    .user("3+5等于几？")
    .call()
    .entity(Answer.class);