This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 75be05b25004 CAMEL-24557: Remove stale langchain4j-tools from AI
observability docs (#25910)
75be05b25004 is described below
commit 75be05b25004f47342ddece2488a70a0e4bc1ffb
Author: Omar Atie <[email protected]>
AuthorDate: Mon Aug 31 00:27:48 2026 -0700
CAMEL-24557: Remove stale langchain4j-tools from AI observability docs
(#25910)
* CAMEL-24557: Remove stale langchain4j-tools from AI observability docs
Drop langchain4j-tools from Phase 1 coverage and remove
CamelLangChain4jToolsRequestModel/ResponseModel header entries
now that camel-langchain4j-tools is removed from camel-ai-parent.
Regenerate catalog ai-observability.adoc to match.
Co-authored-by: Cursor <[email protected]>
* CAMEL-24557: Drop phased wording from GenAI observability docs
Replace Phase 1/3 coverage lists with a single supported-producers
section and remove Phase 2 from the Camel TUI heading. Update the 4.23
upgrade guide to list spring-ai-chat alongside LangChain4j and OpenAI
without phase references.
Co-authored-by: Cursor <[email protected]>
---------
Co-authored-by: Cursor Agent <[email protected]>
---
.../resources/org/apache/camel/catalog/docs/ai-observability.adoc | 8 ++------
.../camel-ai-observability/src/main/docs/ai-observability.adoc | 8 ++------
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_23.adoc | 4 +---
3 files changed, 5 insertions(+), 15 deletions(-)
diff --git
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/ai-observability.adoc
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/ai-observability.adoc
index 603055aa03a6..fd1965df7ce1 100644
---
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/ai-observability.adoc
+++
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/ai-observability.adoc
@@ -23,10 +23,7 @@ Global toggle: set `camel.aiObservability.enabled=false`
(default is `true` when
via `camel.aiObservability.enabled` in application.properties or
programmatically with
`main.configure().aiObservability().withEnabled(false)`.
-Phase 1 coverage: `langchain4j-chat`, `langchain4j-tools`,
`langchain4j-agent`, `langchain4j-embeddings`,
-and `openai`.
-
-Phase 3 coverage: `spring-ai-chat`.
+Supported producers: `langchain4j-chat`, `langchain4j-agent`,
`langchain4j-embeddings`, `openai`, and `spring-ai-chat`.
When using `spring-ai-chat` with only a pre-built `chatClient` (no `chatModel`
on the endpoint), Camel attempts to read
the backing Spring AI `ChatModel` via a private field on Spring AI's internal
`ChatClientRequestSpec` implementation.
@@ -37,7 +34,6 @@ component when GenAI observability is enabled so model
metadata is always popula
New exchange headers for model identification on langchain4j components:
* `CamelLangChain4jChatRequestModel` / `CamelLangChain4jChatResponseModel`
-* `CamelLangChain4jToolsRequestModel` / `CamelLangChain4jToolsResponseModel`
* `CamelLangChain4jAgentRequestModel` / `CamelLangChain4jAgentResponseModel`
* `CamelLangChain4jEmbeddingsRequestModel` /
`CamelLangChain4jEmbeddingsResponseModel`
@@ -77,7 +73,7 @@ Low-cardinality keys: `gen_ai.operation.name`,
`gen_ai.system`, `gen_ai.request.
`camel.component`, and `error.type` on failure. Prompts, completions, and
token counts are not used
as Observation keys.
-== Camel TUI integration (Phase 2)
+== Camel TUI integration
When monitoring a running integration with `camel tui` and observability
enabled, the AI panel usage view
(*Ctrl+U* while the AI panel is open) combines:
diff --git
a/components/camel-ai/camel-ai-observability/src/main/docs/ai-observability.adoc
b/components/camel-ai/camel-ai-observability/src/main/docs/ai-observability.adoc
index 603055aa03a6..fd1965df7ce1 100644
---
a/components/camel-ai/camel-ai-observability/src/main/docs/ai-observability.adoc
+++
b/components/camel-ai/camel-ai-observability/src/main/docs/ai-observability.adoc
@@ -23,10 +23,7 @@ Global toggle: set `camel.aiObservability.enabled=false`
(default is `true` when
via `camel.aiObservability.enabled` in application.properties or
programmatically with
`main.configure().aiObservability().withEnabled(false)`.
-Phase 1 coverage: `langchain4j-chat`, `langchain4j-tools`,
`langchain4j-agent`, `langchain4j-embeddings`,
-and `openai`.
-
-Phase 3 coverage: `spring-ai-chat`.
+Supported producers: `langchain4j-chat`, `langchain4j-agent`,
`langchain4j-embeddings`, `openai`, and `spring-ai-chat`.
When using `spring-ai-chat` with only a pre-built `chatClient` (no `chatModel`
on the endpoint), Camel attempts to read
the backing Spring AI `ChatModel` via a private field on Spring AI's internal
`ChatClientRequestSpec` implementation.
@@ -37,7 +34,6 @@ component when GenAI observability is enabled so model
metadata is always popula
New exchange headers for model identification on langchain4j components:
* `CamelLangChain4jChatRequestModel` / `CamelLangChain4jChatResponseModel`
-* `CamelLangChain4jToolsRequestModel` / `CamelLangChain4jToolsResponseModel`
* `CamelLangChain4jAgentRequestModel` / `CamelLangChain4jAgentResponseModel`
* `CamelLangChain4jEmbeddingsRequestModel` /
`CamelLangChain4jEmbeddingsResponseModel`
@@ -77,7 +73,7 @@ Low-cardinality keys: `gen_ai.operation.name`,
`gen_ai.system`, `gen_ai.request.
`camel.component`, and `error.type` on failure. Prompts, completions, and
token counts are not used
as Observation keys.
-== Camel TUI integration (Phase 2)
+== Camel TUI integration
When monitoring a running integration with `camel tui` and observability
enabled, the AI panel usage view
(*Ctrl+U* while the AI panel is open) combines:
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_23.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_23.adoc
index c75b5b96f677..ef2ecaa1589b 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_23.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_23.adoc
@@ -250,13 +250,11 @@ unchanged and still does not permit any of the ranges
above.
=== camel-ai-observability (GenAI observability)
-LangChain4j and OpenAI producers now emit GenAI observability data
(OpenTelemetry span attributes and
+LangChain4j, OpenAI, and Spring AI chat (`spring-ai-chat`) producers now emit
GenAI observability data (OpenTelemetry span attributes and
Micrometer metrics) when `camel-opentelemetry2` and/or `camel-micrometer` is
on the classpath.
Disable globally with `camel.aiObservability.enabled=false` (default is
enabled). Camel Main also
exposes the same setting via
`main.configure().aiObservability().withEnabled(false)`.
-Spring AI chat (`spring-ai-chat`) producers emit the same GenAI spans and
metrics in Phase 3.
-
When a non-NOOP `ObservationRegistry` is bound in the Camel registry, GenAI
client calls are recorded
as Micrometer Observations (`gen_ai.client.operation`). Camel then skips the
`camel-telemetry` CLIENT
span and the direct `gen_ai.client.operation` timer. Traces and the operation
timer appear only if
