老废物乐园 瓜子的技术笔记 · Java / AI / 金融科技

在 Agent 中如何定义一个好的工具:把接口写给程序,把工具写给模型

工具是 LLM 与真实世界之间的合约。本文从 11 个线上问题出发,拆解 Agent 工具设计的完整清单:命名与读写分离、description 的三要素与职责边界、参数不该让模型猜、返回值里的信号字段、入参校验与幂等、写后验证、异常不外抛,以及为什么工具之间不该靠模型搬数据。关键词:Agent 工具设计、Function Calling、提示词工程。

遥望星星 遥望星星 发布于 2026-09-14

记一笔,地图就亮:一个离线旅行大屏的实现与取舍

用 Spring Boot 3.3.5 + Java 21 做了个旅行足迹大屏:6273 行代码、零外链的单文件前端、975 KB 离线底图,以及两个 AI 功能。 这篇不写教程,只写三件事 —— 我做了什么决定、付了什么代价、以及一次被"演示数据"掩盖的缺陷。 一句话背景 我做了个东西,解决的问题

遥望星星 遥望星星 发布于 2026-09-11

把业务系统改造成 Agent 可用的工具

「为什么 Agent 调我们的接口总是调错」 去年 12 月,业务方提了个需求:让客服 Agent 能直接查订单、查物流、发起退款。我当时的反应是「这不简单吗,把现有的订单服务接口包一层给 Agent 调就行了」。 两周后我收回这句话。Agent 调用我们接口的失败率是 37%,其中大部分不是超时或

遥望星星 遥望星星 发布于 2025-10-04

研发流程中的 AI 卡点设计

把 AI 塞进研发流程半年,哪些卡点活下来了 四月份我们开始在研发流程里加 AI 卡点,到这个月正好半年。团队 14 人,一共试过九个卡点,活下来五个。先说总体结论:AI 卡点的价值不在「生成了多少内容」,而在「拦截了多少问题」——纯生成类的(写文档、写注释)普遍活不下来。 我们试过的九个卡点 卡点

遥望星星 遥望星星 发布于 2025-06-28

AI 编码助手融入团队研发流程的实践

半年过去了,我们团队到底提效了多少 2024 年 10 月我们组 11 个人开始全面用 AI 编码助手,到今年三月底正好半年。这半年里我在各种场合听到的说法从"提效 50%"到"就是个高级补全"都有,差距大到不像在说同一个东西。所以我们拉了数据自己看了一遍,顺便把踩过的坑和定下的规矩记下来。 数据是

遥望星星 遥望星星 发布于 2025-04-10

把 LLM 能力封装成可靠的企业服务

订单系统线程池被一个"智能"功能打满 三月下旬的一个下午,监控突然报警:订单履约服务的 Tomcat 线程池活跃数从平时的 40 冲到 200(最大值),接口 P99 从 180ms 涨到 12s,大量订单卡在"待履约"状态。 排查过程很快。看线程 dump,200 个线程里有 187 个卡在同一个

遥望星星 遥望星星 发布于 2024-10-05

Spring 6.1 的 RestClient 与 HTTP Interface

背景:RestTemplate 越用越别扭 七月我们在预发环境试了 Spring 6.1 的里程碑版本(6.1 当时还没 GA,计划十一月随 Boot 3.2 一起),最让我眼前一亮的是 RestClient 和 HTTP Interface。以前用 RestTemplate,拼 URL、处理异常、

遥望星星 遥望星星 发布于 2022-11-15

Maven 到 Gradle 的迁移决策与实践

背景:一次全量构建喝了杯咖啡还没好 六月我们一个核心服务模块膨胀到 180 个 Maven 模块,mvn install 一次 6 分半。CI 排队严重,开发等得烦躁。我提议评估迁移 Gradle,但团队一半人不乐意——XML 写惯了,怕 DSL 学习成本。于是我做了个对照实验,用同一份源码分别用

遥望星星 遥望星星 发布于 2022-10-10

生产环境 OOM 自动 dump 与分析流水线

半夜的 OOM,却没留下证据 有天凌晨一个服务 OOM 自杀重启,等我早上到公司,堆已经被 GC 一遍、镜像重建了,啥都看不到。这种"看过现场却没拍照"的故障最折磨人,只能凭日志猜是哪块吃内存,结果猜了一上午猜错方向。从那以后我定下规矩:任何 Java 服务 OOM 必须自动留证,不能让现场随重启蒸

遥望星星 遥望星星 发布于 2022-04-30

Maven 多模块项目拆分与依赖管理

编译一次 8 分钟,改一行代码等半天 5 月中旬,我们的主工程已经长成一个 47 个 package、21 万行的单体。mvn clean install 的时间: $ time mvn clean install -DskipTests [INFO] BUILD SUCCESS [INFO] To

遥望星星 遥望星星 发布于 2020-10-06