davsclaus opened a new pull request, #27439: URL: https://github.com/apache/camel/pull/27439
## Summary **AI patterns page** (`ai-patterns.adoc`): the "AI and Agent Integration" table gets rows for the terms people use when building agents. Each row links to the Camel building block: | Term | Building block | |---|---| | Guardrail / guard decision | Semantic + TypeSafe AI (System One model), Filter, Validate | | Tool / function calling | AI Tool | | MCP server | MCP Server, AI Resource | | MCP client | LangChain4j Agent MCP, OpenAI MCP | | Tool authorization / agent permissions | AI Tool authorization, OPA, OpenFGA | | Agent identity / workload identity | SPIFFE | | LLM observability | AI Observability | | RAG ingestion | LangChain4j Ingest | **Canonical YAML in the AI component docs.** 58 YAML examples across 20 pages (camel-ai and camel-spiffe) used the deprecated compact notation: - `to: "..."` - `setBody`/`setHeader`/`setProperty`/`delay`/`script`/`filter` with a bare language key - `when` items with a bare `simple:` - `log: "..."` - a top-level `from:` They are rewritten into the canonical form with a targeted edit that leaves comments, URIs and quoting as written. `camel validate normalize` was not used because it drops comments and splits URIs into `parameters`. **One fix found along the way:** the LLM integration guide used `json-validator:validate?schema=...`, but `json-validator` has no `schema` option; the schema is the endpoint path. Now `json-validator:classpath:schemas/resume.schema.json`. The catalog doc mirrors are regenerated. ## Test plan - [x] `camel validate yaml --canonical` on every route YAML block of the 20 pages: no compact notation left. The remaining messages are about fragments, such as a bean or schema file not in the snippet. - [x] `EipDocExamplesTest` and `UserManualDocExamplesTest` (camel-yaml-dsl-validator) pass - [x] Every new xref target exists. The ai-tool anchor `#_authorizing_tool_calls` matches its heading. _Claude Code on behalf of davsclaus_ 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
