You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by "davsclaus (via GitHub)" <gi...@apache.org> on 2026/10/06 10:54:06 UTC
[PR] chore: docs - Governed AI Agents page in the user manual [camel]
davsclaus opened a new pull request, #27436:
URL: https://github.com/apache/camel/pull/27436
## Summary
Adds a user manual page, **Governed AI Agents** (under Security in the nav). It brings together the 4.23 pieces for governing what an AI agent may do, which are so far spread across component docs and blog posts. In Camel a tool is a route, so the route that does the work also checks each tool call:
| Question | Building block |
|---|---|
| Who is calling? | SPIFFE workload identity and mutual TLS |
| May they do this? | `authorizationPolicy` on `ai-tool`, with OPA (in-process WebAssembly) or OpenFGA; Keycloak, Shiro, Spring Security also fit |
| Does this action make sense? | Semantic language guard decisions with a System One model (TypeSafe AI / Jev) |
| What happened? | GenAI observability: OpenTelemetry spans and Micrometer metrics per LLM call |
The page also covers:
- the two rules that make the decision trustworthy: the tool name comes from the route, and the caller from an exchange property, never a header;
- how in-route checks relate to a perimeter proxy (Wanaku);
- links to the `ai-tools-spiffe-opa` example and the September/October blog posts.
Examples are in Java, XML and YAML using `[tabs]`. The Semantic declarations have Java and YAML only. All examples are taken from the component docs, and the YAML is written in the canonical form.
## Why draft
The `components::` xrefs point at the 4.23 component pages: spiffe, opa, openfga, semantic, typesafe-ai, ai-observability. Those pages are only published once 4.23.0 is released, so this should be merged after the release, which is planned for next week.
## Test plan
- [x] `UserManualDocExamplesTest` (camel-yaml-dsl-validator): every YAML route example of the manual validates
- [x] `CatalogDocJavaExamplesTest` (camel-jbang-core): Java examples of the manual parse
- [x] `camel validate yaml --canonical --catalog` and `camel validate source` on the extracted YAML and XML snippets
- [x] Checked that every xref target page exists under `docs/components`
_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: commits-unsubscribe@camel.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] chore: docs - Governed AI Agents page in the user manual [camel]
Posted by "davsclaus (via GitHub)" <gi...@apache.org>.
davsclaus merged PR #27436:
URL: https://github.com/apache/camel/pull/27436
--
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: commits-unsubscribe@camel.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] chore: docs - Governed AI Agents page in the user manual [camel]
Posted by "apupier (via GitHub)" <gi...@apache.org>.
apupier commented on PR #27436:
URL: https://github.com/apache/camel/pull/27436#issuecomment-6015929843
```
[10:57:26.060] ERROR (asciidoctor): target of xref not found: components::spiffe-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.061] ERROR (asciidoctor): target of xref not found: components::opa-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.061] ERROR (asciidoctor): target of xref not found: components::openfga-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.061] ERROR (asciidoctor): target of xref not found: components:languages:semantic-language.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.062] ERROR (asciidoctor): target of xref not found: components:others:ai-observability.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.064] ERROR (asciidoctor): target of xref not found: components::spiffe-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.065] ERROR (asciidoctor): target of xref not found: components::opa-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.065] ERROR (asciidoctor): target of xref not found: components::openfga-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.066] ERROR (asciidoctor): target of xref not found: components::typesafe-ai-component.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
[10:57:26.067] ERROR (asciidoctor): target of xref not found: components:languages:semantic-language.adoc
file: /home/runner/work/camel/camel/camel/docs/user-manual/modules/ROOT/pages/governed-ai-agents.adoc
source: /home/runner/work/camel/camel/camel (branch: HEAD <worktree> | start path: docs/user-manual)
```
--
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: commits-unsubscribe@camel.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] chore: docs - Governed AI Agents page in the user manual [camel]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on PR #27436:
URL: https://github.com/apache/camel/pull/27436#issuecomment-6014727851
:star2: Thank you for your contribution to the Apache Camel project! :star2:
:robot: CI automation will test this PR automatically.
:camel: Apache Camel Committers, please review the following items:
* First-time contributors **require MANUAL approval** for the GitHub Actions to run
* You can use the command `/component-test (camel-)component-name1 (camel-)component-name2..` to request a test from the test bot although they are normally detected and executed by CI.
* You can label PRs using `skip-tests` and `test-dependents` to fine-tune the checks executed by this PR.
* Build and test logs are available in the summary page. **Only** [Apache Camel committers](https://camel.apache.org/community/team/#committers) have access to the summary.
:warning: Be careful when sharing logs. Review their contents before sharing them publicly.
--
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: commits-unsubscribe@camel.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] chore: docs - Governed AI Agents page in the user manual [camel]
Posted by "davsclaus (via GitHub)" <gi...@apache.org>.
davsclaus commented on PR #27436:
URL: https://github.com/apache/camel/pull/27436#issuecomment-6015961585
yes it needs 4.23 released that carries that new components and languages
--
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: commits-unsubscribe@camel.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] chore: docs - Governed AI Agents page in the user manual [camel]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on PR #27436:
URL: https://github.com/apache/camel/pull/27436#issuecomment-6014941344
<!-- ci-tested-modules -->
:test_tube: **CI tested the following changed modules:**
- `docs`
---
<details><summary>:microscope: Scalpel shadow comparison — Scalpel: 0 of 698 tested, 0 compile-only — current: 0 all tested</summary>
[Maveniverse Scalpel](https://github.com/maveniverse/scalpel) detected **0 affected modules** (current approach: 0).
**Skip-tests mode would test 0 modules** (1 direct + 0 downstream), **skip tests for 0** (generated code, meta-modules)
<details><summary>Modules Scalpel would test (0)</summary>
</details>
> :information_source: Shadow mode — Scalpel observes but does not affect test execution. [Learn more](https://github.com/maveniverse/scalpel)
</details>
---
:gear: [View full build and test results](https://github.com/apache/camel/actions/runs/37452839981)
--
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: commits-unsubscribe@camel.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org