Spring AI 实战：Agent 基础搭建与核心能力解析

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.example</groupId>
        <artifactId>Weiz-SpringAI-Agent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <artifactId>Weiz-SpringAI-Agent-QuickStart</artifactId>
    <name>Weiz-SpringAI-Agent-QuickStart</name>
    <description>Weiz-SpringAI-Agent-QuickStart</description>

    <properties>
        <java.version>17</java.version>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-starter-model-zhipuai</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-client-chat</artifactId>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

# 应用基础配置
spring.application.name=SpringAIAgentDemo
server.port=8084
# 智普 AI 配置
spring.ai.zhipuai.api-key=你的智普 AI API Key
spring.ai.zhipuai.base-url=https://open.bigmodel.cn/api/paas
spring.ai.zhipuai.chat.options.model=GLM-4-Flash
# 日志配置（便于调试）
logging.level.org.springframework.ai=INFO
logging.level.com.example=DEBUG

package com.example.weizspringai.service;

import org.springframework.ai.chat.client.ChatClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class TripPlanningAgentService {

    @Autowired
    private ChatClient chatClient;

    /**
     * Agent 核心能力：接收出行需求，生成完整行程规划
     *
     * @param tripDemand 用户出行需求（包含时间、地点、偏好等）
     * @return 完整行程规划（按天/按时段拆分）
     */
    public String planTrip(String tripDemand) {
        // 定义 Agent 行为规则：引导大模型完成行程规划
        String systemPrompt = """
                你是一个专业的智能行程规划 Agent，核心职责是根据用户出行需求，生成完整、可执行的行程方案，规则如下：
                1. 先拆解需求核心要素：出行时间、目的地、人数、偏好（景点类型、饮食、交通方式）、禁忌；
                2. 行程按天拆分，每天按时间段（上午/下午/晚上）规划，包含景点、交通、餐饮、停留时长；
                3. 景点选择贴合用户偏好，餐饮适配饮食禁忌，交通路线合理（避免绕路）；
                4. 补充实用提示（如景点开放时间、预约要求、穿搭建议）；
                5. 语言简洁明了，结构清晰，便于用户直接参考执行。
                """;

        StringBuilder response = new StringBuilder();
        try {
            // 调用大模型完成行程规划（模拟 Agent 自主规划能力）
            return chatClient.prompt()
                    .system(systemPrompt)
                    .user("请根据以下出行需求生成完整行程规划：" + tripDemand)
                    .call()
                    .content();
        }catch (Exception e) {
            System.out.println("调用AI模型失败"+e.getMessage());
            return "调用AI模型失败"+e.getMessage();
        }
    }
}

package com.example.weizspringai.controller;

import com.example.weizspringai.service.TripPlanningAgentService;
import lombok.RequiredArgsConstructor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.Map;

@RestController
@RequestMapping("/agent/trip")
@RequiredArgsConstructor
public class AgentController {

    @Autowired
    private TripPlanningAgentService tripPlanningAgentService;

    /**
     * 行程规划接口：接收出行需求，返回完整行程方案
     */
    @GetMapping("/plan")
    public Map<String, String> planTrip(@RequestParam("demand") String demand) {
        String tripPlan = tripPlanningAgentService.planTrip(demand);
        return Map.of(
                "userDemand", demand,
                "tripPlan", tripPlan,
                "agentType", "智能行程规划 Agent"
        );
    }
}

{
  "userDemand": "周末两天北京短途游，2人，偏好人文景点，不吃辣，交通以地铁为主",
  "tripPlan": "### 北京周末两天短途游行程规划\n\n#### 第一天：历史文化体验\n\n**上午**\n- **9:00-10:30**：**天安门广场**\n  - 景点：参观毛主席纪念堂（需提前预约），游览天安门广场。\n  - 交通：地铁1号线天安门东站下车。\n  - 餐饮建议：附近有王府井小吃街，可品尝京味小吃，但请注意避免辣食。\n\n- **10:45-12:00**：**故宫博物院**\n  - 景点：参观故宫，了解中国古代皇家文化。\n  - 交通：步行至故宫东华门，乘坐地铁1号线或2号线至天安门东站。\n  - 餐饮建议：故宫附近有“故宫角楼餐厅”，提供不辣的宫廷小吃。\n\n**下午**\n- **12:30-14:00**：午餐\n  - 餐饮建议：选择“老北京炸酱面”或“豆汁儿”等不辣的北京特色美食。\n\n- **14:30-16:00**：**南锣鼓巷**\n  - 景点：游览南锣鼓巷，体验老北京胡同文化。\n  - 交通：步行或乘坐地铁8号线南锣鼓巷站下车。\n\n- **16:15-17:30**：**什刹海**\n  - 景点：参观后海、前海，感受北京古都的宁静。\n  - 交通：步行从南锣鼓巷前往什刹海。\n\n**晚上**\n- **18:00-19:30**：晚餐\n  - 餐饮建议：选择“全聚德”烤鸭或其他不辣的北京菜馆。\n\n- **20:00-21:30**：**王府井步行街**\n  - 景点：逛王府井步行街，体验北京现代都市风貌。\n  - 交通：步行或乘坐地铁1号线王府井站下车。\n\n#### 第二天：艺术与休闲\n\n**上午**\n- **9:00-10:30**：**国家大剧院**\n  - 景点：参观国家大剧院，欣赏建筑艺术。\n  - 交通：地铁1号线天安门东站下车，步行至国家大剧院。\n\n- **11:00-12:00**：**中央美术学院美术馆**\n  - 景点：参观美术馆，感受艺术氛围。\n  - 交通：步行至中央美术学院美术馆。\n\n**下午**\n- **12:30-14:00**：午餐\n  - 餐饮建议：选择“京味斋”等提供不辣的北京菜馆。\n\n- **14:30-16:00**：**798艺术区**\n  - 景点：游览798艺术区，感受现代艺术气息。\n  - 交通：乘坐地铁6号线至东四十条站，步行至798艺术区。\n\n**晚上**\n- **18:00-19:30**：晚餐\n  - 餐饮建议：选择“西四老馆”等不辣的北京特色餐厅。\n\n- **20:00-21:30**：**后海酒吧街**\n  - 景点：在酒吧街享受夜晚的休闲时光。\n  - 交通：乘坐地铁6号线至南锣鼓巷站，步行至后海酒吧街。\n\n### 实用提示\n- **预约**：故宫、毛主席纪念堂等景点需提前预约。\n- **穿搭建议**：根据天气情况，建议穿着舒适、便于行走的服装。\n- **交通**：以地铁为主，部分景点间步行可达，避免高峰期拥堵。\n\n希望这份行程规划能帮助您享受愉快的北京周末之旅！",
  "agentType": "智能行程规划 Agent"
}

{
  "userDemand": "单日西安历史文化游，1人，喜欢古建筑，素食主义者，希望行程宽松",
  "tripPlan": "### 西安历史文化单日游行程规划\n\n#### 出行日期：[请填写具体日期]\n#### 人数：1人\n#### 偏好：\n- 景点类型：古建筑\n- 饮食：素食\n- 交通方式：步行为主，公共交通辅助\n\n#### 禁忌：\n- 无特殊禁忌\n\n### 行程安排\n\n#### 上午：\n- **08:00 - 09:00**：**早餐** - 在回民街品尝素食早餐，如素食肉夹馍、豆腐脑等。\n- **09:30 - 11:30**：**陕西历史博物馆** - 参观古建筑，了解陕西历史文化。建议提前在线预约门票，博物馆内可自备午餐。\n- **停留时长**：1.5小时\n\n#### 下午：\n- **12:00 - 13:00**：**午餐** - 在博物馆附近的素食餐厅用餐，如“素满园”。\n- **13:30 - 15:30**：**大雁塔** - 参观唐代著名佛塔，周围有多个古建筑群，适合悠闲漫步。\n- **停留时长**：1.5小时\n\n#### 晚上：\n- **16:00 - 17:30**：**小雁塔** - 参观另一座唐代古塔，欣赏周边夜景。\n- **18:00 - 19:00**：**晚餐** - 在大雁塔附近选择一家素食餐厅，如“素食园”。\n- **停留时长**：1小时\n\n#### 实用提示：\n- **陕西历史博物馆**：建议提前一天预约，开放时间为9:00-17:00，16:00停止入场。\n- **素食餐厅**：西安有众多素食餐厅，可根据个人口味选择。\n- **穿搭建议**：建议穿着舒适，以休闲装为主，适合步行。\n- **交通**：步行为主，如需公共交通，可使用西安公交或地铁，注意查看路线和时间表。\n\n### 行程总结\n本行程以参观古建筑为主，结合素食饮食，适合喜欢悠闲游览的素食主义者。行程安排宽松，让游客能够充分感受西安的历史文化氛围。",
  "agentType": "智能行程规划 Agent"
}