From 154be6b59471d91ee705f2c87499caa004187342 Mon Sep 17 00:00:00 2001
From: Geertjan Wielenga <geertjan@apache.org>
Date: Thu, 12 Nov 2026 09:44:10 +0100
Subject: [PATCH 1/3] draft: add evaluating Java AI agents with Harness Evals

Article covers harness-evals framework for evaluating LLM agents,
including Spring AI integration, OpenTelemetry support, and CI gating.

AI-Session-Id: ec3a6019-33e9-470a-9a37-6e8018287660
AI-Tool: claude-code
AI-Model: unknown
---
 .../harness-evals.jpg                         | Bin 0 -> 46152 bytes
 .../index.md                                  | 186 ++++++++++++++++++
 2 files changed, 186 insertions(+)
 create mode 100644 draft/evaluating-java-ai-agents-with-harness-evals/harness-evals.jpg
 create mode 100644 draft/evaluating-java-ai-agents-with-harness-evals/index.md

diff --git a/draft/evaluating-java-ai-agents-with-harness-evals/harness-evals.jpg b/draft/evaluating-java-ai-agents-with-harness-evals/harness-evals.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..248641f58040b5d319955b8b0d761bad76f06875
GIT binary patch
literal 46152
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

literal 0
HcmV?d00001

diff --git a/draft/evaluating-java-ai-agents-with-harness-evals/index.md b/draft/evaluating-java-ai-agents-with-harness-evals/index.md
new file mode 100644
index 000000000..d6de74f94
--- /dev/null
+++ b/draft/evaluating-java-ai-agents-with-harness-evals/index.md
@@ -0,0 +1,186 @@
+---
+title: "Evaluating Java AI Agents with Harness Evals"
+date: "2026-11-11"
+description: "Your agent passed its unit tests. Is it any good? Learn how to use harness-evals to evaluate Java AI agents."
+authors:
+  - "geertjan-wielenga"
+categories:
+  - "Java"
+  - "AI"
+  - "Testing"
+  - "GenAI"
+related_posts:
+  - "spring-ai-how-to-write-genai-applications-with-java"
+  - "building-robust-ai-applications-with-langchain4j-guardrails-and-spring-boot"
+  - "opentelemetry-tracing-on-spring-boot-java-agent-vs-micrometer-tracing"
+  - "ai-driven-testing-best-practices"
+image: "harness-evals.jpg"
+---
+
+If you're building agents in Java with Spring AI or LangChain4j, you know that a green JUnit run tells you very little about whether the thing actually works. The same prompt gives a different answer on Tuesday than on Monday. A model upgrade changes which tools get called. A cheaper model saves money and nobody notices it now gets one answer in five wrong.
+
+What you need is **evals**: repeatable, scored checks of what your agent says and does, run against a dataset, compared over time, and wired into CI. [harness-evals](https://github.com/harness/harness-evals), open-sourced by Harness under the Apache 2.0 license, is one of the more complete frameworks for this I've come across. It's written in Python, but as you'll see, that doesn't stop you from pointing it at a Java agent.
+
+## What harness-evals is
+
+harness-evals is an evaluation framework for LLM agents, prompts and structured outputs. Its central design choice: every metric returns a Score between 0.0 and 1.0, and a configurable threshold decides pass or fail. There is no hidden state.
+
+Every metric belongs to one of five dimensions, so a suite of metrics tells you not only "pass" or "fail" but where your agent is strong and where it is weak:
+
+| Dimension | Question it answers | Example metrics |
+|-----------|---------------------|-----------------|
+| Correctness | Is it right? | ExactMatch, TaskCompletion, GEval, GoalAccuracy |
+| Groundedness | Is it supported by evidence? | Faithfulness, SpecGrounding, ContextPrecision |
+| Safety | Did it violate policy? | PII, Toxicity, PromptInjection, Hallucination |
+| Trajectory | Did it take a good path? | PlanAdherence, StepEfficiency, ToolCorrectness |
+| Performance | Was it fast and cheap? | Latency, TokenCost, CostEfficiency |
+
+The metric catalogue is big. It ranges from cheap deterministic checks (exact match, regex, JSON diff, schema validation) through RAG metrics and LLM-as-judge scoring, to multi-turn conversation metrics, reliability across repeated runs, and even standard benchmarks such as MMLU, GSM8K and HumanEval. Safety metrics are reported separately and never averaged into a headline number, which is the right call.
+
+## Four concepts to know
+
+You need only a handful of ideas to get going:
+
+- **Golden**: what you author. An input, the expected output and optional context, stored as JSONL or JSON.
+- **EvalCase**: what metrics receive. A Golden enriched with what the agent actually produced, plus runtime data such as latency, tokens, cost and tool calls.
+- **Metric**: a class with a `measure()` method that turns an EvalCase into a Score. Writing your own is a dozen lines.
+- **Target**: the system under test. A `PromptTarget` renders a prompt through an LLM; an `HttpTarget` POSTs to a deployed agent endpoint.
+
+That last one is what makes this interesting for Java developers. Your agent doesn't need to be Python. It needs an HTTP endpoint.
+
+## Pointing it at a Spring AI agent
+
+Out of the box, `HttpTarget` POSTs `{"input": "..."}` to your endpoint and reads the answer from `$.output` in the response. So the only thing your Java agent needs is a small controller with that shape:
+
+```java
+@RestController
+class AgentController {
+
+    private final ChatClient chatClient;
+
+    AgentController(ChatClient.Builder builder) {
+        this.chatClient = builder
+                .defaultSystem("You are a support assistant for our product.")
+                .build();
+    }
+
+    record AgentRequest(String input) {}
+    record AgentResponse(String output) {}
+
+    @PostMapping("/run")
+    AgentResponse run(@RequestBody AgentRequest request) {
+        String answer = chatClient.prompt()
+                .user(request.input())
+                .call()
+                .content();
+        return new AgentResponse(answer);
+    }
+}
+```
+
+Next, write a few goldens in `goldens.jsonl`, one JSON object per line:
+
+```json
+{"id": "reset-password", "input": "How do I reset my password?", "expected": "Use the Forgot password link on the sign-in page."}
+{"id": "export-csv", "input": "Can I export my data as CSV?", "expected": "Yes, from Settings, Export."}
+```
+
+Then describe the eval in YAML. Exact match is useless for free-text answers, so this config uses an LLM judge for correctness and a latency budget for performance:
+
+```yaml
+# support-agent.eval.yaml
+name: support-agent
+dataset: ./goldens.jsonl
+
+target:
+  type: http
+  url: http://localhost:8080/run
+  output_path: $.output
+  timeout_s: 30
+  retries: 2
+
+metrics:
+  - {kind: geval, threshold: 0.7, params: {criteria: "Is the answer correct and helpful compared to the expected answer?"}}
+  - {kind: latency, threshold: 0.5, params: {max_ms: 5000}}
+
+judge_llm: {provider: openai, name: gpt-4o}
+sinks: [stdout]
+```
+
+Start the Spring Boot app, then run:
+
+```bash
+pip install "harness-evals[llm]"
+harness-evals run support-agent.eval.yaml
+```
+
+If your response carries more than just text, `HttpTarget` can pick it up too. Point `tool_calls_path`, `context_path`, `token_count_path` or `cost_usd_path` at the matching JSON fields, and metrics like `tool_correctness`, `faithfulness` and `token_cost` light up. If your API takes a different request shape, `body_template` lets you map golden fields into whatever JSON your controller expects.
+
+## OpenTelemetry in both directions
+
+The part I find most compelling is that harness-evals speaks OpenTelemetry on the way in and on the way out.
+
+On the way in, the OTel importer turns spans into an EvalCase. It classifies spans using the OTel GenAI semantic conventions, looking at attributes such as `gen_ai.operation.name`, `gen_ai.input.messages`, `gen_ai.output.messages` and `gen_ai.tool.name`. Spring AI's observability support already emits `gen_ai.*` attributes, so traces from your production Java agent can become eval cases without a separate logging path:
+
+```python
+from harness_evals import evaluate
+from harness_evals.importers.otel import OTELEvalCaseSource
+from harness_evals.metrics import LatencyMetric, PIIMetric
+
+ec = OTELEvalCaseSource.from_spans(collected_spans)
+scores = evaluate(ec, metrics=[LatencyMetric(max_ms=3000), PIIMetric()])
+```
+
+That means you can score what real users actually experienced, not only what your curated goldens predicted. Run a PII check over last week's production traces and you'll learn something.
+
+On the way out, `OtlpSink` exports eval scores as OTLP metrics and traces to any OpenTelemetry-compatible backend. You can attach the eval spans to an existing trace via a parent context, so an eval run shows up next to the request it judged:
+
+```python
+from harness_evals.sinks.otlp_sink import OtlpSink
+
+sink = OtlpSink(
+    endpoint="http://collector:4317",
+    run_id="nightly-001",
+    resource_attributes={"deployment.environment": "ci"},
+)
+scores = evaluate(ec, metrics=[...], sinks=[sink])
+```
+
+Eval quality then becomes another signal in your observability stack, on the same dashboards and alerts as latency and error rates.
+
+## Gating your build
+
+The CLI is built for CI. `harness-evals run` exits with 0 on pass, 1 on a failure or regression, and 2 on a config error, so any pipeline can gate on it. Two independent checks are available:
+
+- `--fail-under 0.8` sets an absolute quality floor.
+- `--baseline` compares the run against stored scores (add `baseline: {store: json, path: .evals/baseline.json}` to the YAML) and fails on regressions beyond a tolerance. `--update-baseline` refreshes the snapshot once you accept a change.
+
+In a GitHub Actions workflow for a Maven project, that looks roughly like this:
+
+```yaml
+- run: ./mvnw -q spring-boot:start
+- run: pip install "harness-evals[llm]"
+- run: harness-evals run support-agent.eval.yaml --baseline --fail-under 0.8
+  env:
+    OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+- run: ./mvnw -q spring-boot:stop
+```
+
+Now a prompt tweak, a model swap or a Spring AI upgrade that makes your agent worse fails the build, like a broken unit test would.
+
+## Things to know before you start
+
+- **It's a Python tool.** There's no Java SDK, so custom metrics and sinks are written in Python. For black-box evaluation over HTTP or traces, that barely matters.
+- **LLM judges cost money.** GEval, faithfulness and the conversation metrics all call a judge model. Keep deterministic metrics like JSON diff, schema validation, latency and tool correctness in the mix, and run the judged ones on a sensible subset.
+- **Judges should differ from the judged.** The prompt optimizer even rejects using the same model instance as both, and that's good advice for any eval setup.
+- **It's young.** At the time of writing the repo has 37 stars and an active issue list, so expect the API to move.
+
+## Wrapping up
+
+harness-evals brings a clear model to a messy problem: goldens in, scores from 0 to 1 out, grouped into five dimensions that tell you what kind of wrong your agent is. For Java developers, the HTTP target and the OpenTelemetry importer and sink mean you can adopt it without rewriting anything. Your Spring AI or LangChain4j agent stays as it is; the evals wrap around it.
+
+Start small: ten goldens, one judged metric, one latency budget, run in CI. Then look at what your production traces say.
+
+- **Repository**: [github.com/harness/harness-evals](https://github.com/harness/harness-evals)
+- **Integration guide**: docs/integration-guide.md (pytest, GitHub Actions, GitLab CI)
+- **HTTP agent example config**: examples/http-agent.eval.yaml

From a083dd1b9cdfca72782547640c624191d8c576c8 Mon Sep 17 00:00:00 2001
From: Geertjan Wielenga <geertjan@apache.org>
Date: Thu, 12 Nov 2026 09:52:04 +0100
Subject: [PATCH 2/3] fix: address CodeRabbit review comments

- Add OpenAI API key requirement to local setup instructions
- Include expected_tools in golden dataset examples
- Add OTLP extra installation before OtlpSink usage
- Add sink.shutdown() in finally block after evaluation
- Clarify that Spring AI traces omit content by default, explain privacy implications
- Explain baseline file creation workflow for CI

All changes address functional correctness gaps that would prevent readers
from reproducing the examples.

AI-Session-Id: ec3a6019-33e9-470a-9a37-6e8018287660
AI-Tool: claude-code
AI-Model: unknown
---
 .../index.md                                  | 30 ++++++++++++++-----
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/draft/evaluating-java-ai-agents-with-harness-evals/index.md b/draft/evaluating-java-ai-agents-with-harness-evals/index.md
index d6de74f94..5e414c53b 100644
--- a/draft/evaluating-java-ai-agents-with-harness-evals/index.md
+++ b/draft/evaluating-java-ai-agents-with-harness-evals/index.md
@@ -81,8 +81,8 @@ class AgentController {
 Next, write a few goldens in `goldens.jsonl`, one JSON object per line:
 
 ```json
-{"id": "reset-password", "input": "How do I reset my password?", "expected": "Use the Forgot password link on the sign-in page."}
-{"id": "export-csv", "input": "Can I export my data as CSV?", "expected": "Yes, from Settings, Export."}
+{"id": "reset-password", "input": "How do I reset my password?", "expected": "Use the Forgot password link on the sign-in page.", "expected_tools": ["reset_help"]}
+{"id": "export-csv", "input": "Can I export my data as CSV?", "expected": "Yes, from Settings, Export.", "expected_tools": ["export_settings"]}
 ```
 
 Then describe the eval in YAML. Exact match is useless for free-text answers, so this config uses an LLM judge for correctness and a latency budget for performance:
@@ -107,9 +107,10 @@ judge_llm: {provider: openai, name: gpt-4o}
 sinks: [stdout]
 ```
 
-Start the Spring Boot app, then run:
+Start the Spring Boot app. Before running the judge, set your OpenAI API key:
 
 ```bash
+export OPENAI_API_KEY=sk-...
 pip install "harness-evals[llm]"
 harness-evals run support-agent.eval.yaml
 ```
@@ -120,7 +121,11 @@ If your response carries more than just text, `HttpTarget` can pick it up too. P
 
 The part I find most compelling is that harness-evals speaks OpenTelemetry on the way in and on the way out.
 
-On the way in, the OTel importer turns spans into an EvalCase. It classifies spans using the OTel GenAI semantic conventions, looking at attributes such as `gen_ai.operation.name`, `gen_ai.input.messages`, `gen_ai.output.messages` and `gen_ai.tool.name`. Spring AI's observability support already emits `gen_ai.*` attributes, so traces from your production Java agent can become eval cases without a separate logging path:
+On the way in, the OTel importer turns spans into an EvalCase. It classifies spans using the OTel GenAI semantic conventions, looking at attributes such as `gen_ai.operation.name`, `gen_ai.input.messages`, `gen_ai.output.messages` and `gen_ai.tool.name`. 
+
+**Important**: Spring AI's default observability emits `gen_ai.*` attributes but **omits prompt and completion content** for privacy. Imported cases may have empty outputs, and safety metrics like PII will not check response content. To capture content, configure Spring AI's tracer to include `gen_ai.request.model` and the full message text in span attributes, and consider the privacy implications of capturing sensitive prompts and responses in observable spans.
+
+With this context, traces from your production Java agent can become eval cases without a separate logging path:
 
 ```python
 from harness_evals import evaluate
@@ -133,7 +138,15 @@ scores = evaluate(ec, metrics=[LatencyMetric(max_ms=3000), PIIMetric()])
 
 That means you can score what real users actually experienced, not only what your curated goldens predicted. Run a PII check over last week's production traces and you'll learn something.
 
-On the way out, `OtlpSink` exports eval scores as OTLP metrics and traces to any OpenTelemetry-compatible backend. You can attach the eval spans to an existing trace via a parent context, so an eval run shows up next to the request it judged:
+On the way out, `OtlpSink` exports eval scores as OTLP metrics and traces to any OpenTelemetry-compatible backend. You can attach the eval spans to an existing trace via a parent context, so an eval run shows up next to the request it judged.
+
+First, install the OTLP extra:
+
+```bash
+pip install "harness-evals[otlp]"
+```
+
+Then export scores:
 
 ```python
 from harness_evals.sinks.otlp_sink import OtlpSink
@@ -143,7 +156,10 @@ sink = OtlpSink(
     run_id="nightly-001",
     resource_attributes={"deployment.environment": "ci"},
 )
-scores = evaluate(ec, metrics=[...], sinks=[sink])
+try:
+    scores = evaluate(ec, metrics=[...], sinks=[sink])
+finally:
+    sink.shutdown()
 ```
 
 Eval quality then becomes another signal in your observability stack, on the same dashboards and alerts as latency and error rates.
@@ -153,7 +169,7 @@ Eval quality then becomes another signal in your observability stack, on the sam
 The CLI is built for CI. `harness-evals run` exits with 0 on pass, 1 on a failure or regression, and 2 on a config error, so any pipeline can gate on it. Two independent checks are available:
 
 - `--fail-under 0.8` sets an absolute quality floor.
-- `--baseline` compares the run against stored scores (add `baseline: {store: json, path: .evals/baseline.json}` to the YAML) and fails on regressions beyond a tolerance. `--update-baseline` refreshes the snapshot once you accept a change.
+- `--baseline` compares the run against stored scores (add `baseline: {store: json, path: .evals/baseline.json}` to the YAML) and fails on regressions beyond a tolerance. `--update-baseline` refreshes the snapshot once you accept a change. Run `--update-baseline` locally, then commit `.evals/baseline.json` to the repo. CI reads that committed file for comparisons.
 
 In a GitHub Actions workflow for a Maven project, that looks roughly like this:
 

From 1a58716ee3ef05695a0849360ea9bcdb65776cc2 Mon Sep 17 00:00:00 2001
From: Geertjan Wielenga <geertjan@apache.org>
Date: Thu, 12 Nov 2026 10:05:37 +0100
Subject: [PATCH 3/3] fix: address CodeRabbit follow-up comments

- Add tool_calls_path to HttpTarget config example
- Show sample controller response with tool_calls extraction
- Add tool_correctness metric to config
- Provide concrete Spring AI configuration for capturing trace content
- Add privacy safeguards: access controls, retention policies, data classification
- Clarify that security team approval is needed before enabling content export

Addresses follow-up verification comments on expected_tools, OTLP, and
trace content capture.
---
 .../index.md                                  | 31 +++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/draft/evaluating-java-ai-agents-with-harness-evals/index.md b/draft/evaluating-java-ai-agents-with-harness-evals/index.md
index 5e414c53b..de62ed846 100644
--- a/draft/evaluating-java-ai-agents-with-harness-evals/index.md
+++ b/draft/evaluating-java-ai-agents-with-harness-evals/index.md
@@ -85,7 +85,7 @@ Next, write a few goldens in `goldens.jsonl`, one JSON object per line:
 {"id": "export-csv", "input": "Can I export my data as CSV?", "expected": "Yes, from Settings, Export.", "expected_tools": ["export_settings"]}
 ```
 
-Then describe the eval in YAML. Exact match is useless for free-text answers, so this config uses an LLM judge for correctness and a latency budget for performance:
+Then describe the eval in YAML. Exact match is useless for free-text answers, so this config uses an LLM judge for correctness, tool usage metrics, and a latency budget:
 
 ```yaml
 # support-agent.eval.yaml
@@ -96,17 +96,36 @@ target:
   type: http
   url: http://localhost:8080/run
   output_path: $.output
+  tool_calls_path: $.tool_calls
   timeout_s: 30
   retries: 2
 
 metrics:
   - {kind: geval, threshold: 0.7, params: {criteria: "Is the answer correct and helpful compared to the expected answer?"}}
+  - {kind: tool_correctness, threshold: 0.8}
   - {kind: latency, threshold: 0.5, params: {max_ms: 5000}}
 
 judge_llm: {provider: openai, name: gpt-4o}
 sinks: [stdout]
 ```
 
+Your controller should return tool calls in the response. For example:
+
+```java
+record AgentResponse(String output, List<String> tool_calls) {}
+
+@PostMapping("/run")
+AgentResponse run(@RequestBody AgentRequest request) {
+    String answer = chatClient.prompt()
+            .user(request.input())
+            .call()
+            .content();
+    // Extract tool calls from the response
+    List<String> tools = extractToolCalls(answer);
+    return new AgentResponse(answer, tools);
+}
+```
+
 Start the Spring Boot app. Before running the judge, set your OpenAI API key:
 
 ```bash
@@ -123,7 +142,15 @@ The part I find most compelling is that harness-evals speaks OpenTelemetry on th
 
 On the way in, the OTel importer turns spans into an EvalCase. It classifies spans using the OTel GenAI semantic conventions, looking at attributes such as `gen_ai.operation.name`, `gen_ai.input.messages`, `gen_ai.output.messages` and `gen_ai.tool.name`. 
 
-**Important**: Spring AI's default observability emits `gen_ai.*` attributes but **omits prompt and completion content** for privacy. Imported cases may have empty outputs, and safety metrics like PII will not check response content. To capture content, configure Spring AI's tracer to include `gen_ai.request.model` and the full message text in span attributes, and consider the privacy implications of capturing sensitive prompts and responses in observable spans.
+**Important**: Spring AI's default observability emits `gen_ai.*` attributes but **omits prompt and completion content** for privacy. Imported cases may have empty outputs, and safety metrics like PII will not check response content.
+
+To capture content, set `spring.ai.chat.client.observability.enabled=true` and configure the tracer to export `gen_ai.request.messages.0.content` and `gen_ai.response.messages.0.content` attributes. This requires careful handling:
+
+- **Access controls**: Restrict trace access to authorized personnel only; do not export to public observability backends.
+- **Retention**: Set a short TTL (e.g., 7 days) for traces containing prompts or responses.
+- **Data classification**: Ensure your organization's security team approves trace content export before enabling it.
+
+With these safeguards in place, configure your trace backend with retention policies and access controls before enabling content capture.
 
 With this context, traces from your production Java agent can become eval cases without a separate logging path: