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 c2719910a46d chore: camel-jbang - docs demos of AI in action (#27657)
c2719910a46d is described below
commit c2719910a46dc45f85bdd5b6c2e4b057ff1c61f0
Author: Claus Ibsen <[email protected]>
AuthorDate: Sat Oct 10 12:58:57 2026 +0200
chore: camel-jbang - docs demos of AI in action (#27657)
Animated demos of fix with AI on a local model, Claude Code over ACP, and
an agent explaining the integration over MCP, added to the Source Editor, AI
Agents and Ways to Use AI pages; the fix with AI screenshot is retaken.
Signed-off-by: Claus Ibsen <[email protected]>
Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
---
.../images/jbang/camel-tui-ai-acp-claude-code.gif | Bin 0 -> 486422 bytes
.../images/jbang/camel-tui-ai-agent-teaching.gif | Bin 0 -> 557096 bytes
.../ROOT/images/jbang/camel-tui-fix-with-ai.gif | Bin 0 -> 1032618 bytes
.../images/jbang/camel-tui-source-fix-with-ai.png | Bin 436980 -> 323369 bytes
.../ROOT/pages/camel-jbang-tui-ai-agents.adoc | 4 ++++
.../ROOT/pages/camel-jbang-tui-ai-ways.adoc | 6 ++++++
.../ROOT/pages/camel-jbang-tui-source-editor.adoc | 6 ++++++
7 files changed, 16 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/images/jbang/camel-tui-ai-acp-claude-code.gif
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-ai-acp-claude-code.gif
new file mode 100644
index 000000000000..23dd1855baba
Binary files /dev/null and
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-ai-acp-claude-code.gif
differ
diff --git
a/docs/user-manual/modules/ROOT/images/jbang/camel-tui-ai-agent-teaching.gif
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-ai-agent-teaching.gif
new file mode 100644
index 000000000000..5b50351250f9
Binary files /dev/null and
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-ai-agent-teaching.gif
differ
diff --git
a/docs/user-manual/modules/ROOT/images/jbang/camel-tui-fix-with-ai.gif
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-fix-with-ai.gif
new file mode 100644
index 000000000000..19fcfcc36036
Binary files /dev/null and
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-fix-with-ai.gif differ
diff --git
a/docs/user-manual/modules/ROOT/images/jbang/camel-tui-source-fix-with-ai.png
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-source-fix-with-ai.png
index 228daef19d50..835a7e98042c 100644
Binary files
a/docs/user-manual/modules/ROOT/images/jbang/camel-tui-source-fix-with-ai.png
and
b/docs/user-manual/modules/ROOT/images/jbang/camel-tui-source-fix-with-ai.png
differ
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-agents.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-agents.adoc
index 149511bec45c..fd312ae018d1 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-agents.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-agents.adoc
@@ -35,6 +35,8 @@ have -- and can act on it. The agent can:
read the message trace, correlate with route statistics, and produce a
diagnostic report
with annotated screenshots showing exactly where and why the failure occurred
+image::jbang/camel-tui-ai-agent-teaching.gif[An agent connected over MCP
explains the integration with arrows and notes on the topology and the route
statistics]
+
== Enabling MCP
[source,bash]
@@ -80,6 +82,8 @@ gives it the TUI's own MCP server, and shows the agent's
answer, tool calls and
drives the TUI through the same `tui_*` tools that external MCP clients use,
and can also read and edit your
route sources with its own tools.
+image::jbang/camel-tui-ai-acp-claude-code.gif[Claude Code picked with Ctrl+P
in the AI panel answers a question about the running integration from the TUI's
tools]
+
Any agent that speaks ACP works. Press *Ctrl+P* in the AI panel and pick one
of the agents known to work, or
`acp:custom` to run any other ACP agent:
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-ways.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-ways.adoc
index 7e001fb87753..033cf5d9d6d9 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-ways.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-ai-ways.adoc
@@ -56,6 +56,8 @@ tool set to keep prompts short.
Pick this when you want answers inside the TUI with no other tool installed,
or when you want to run a local model.
+image::jbang/camel-tui-fix-with-ai.gif[A local model fixes a failing route
from the AI panel: Shift+F8, the diff, and dev mode reloading the route]
+
* xref:camel-jbang-tui-ai.adoc[Camel TUI AI Panel] -- providers, slash
commands, AI project overview, AI log
* xref:camel-jbang-tui-local-models.adoc[Camel TUI Local Models] -- Ollama,
OpenAI-compatible servers, what a question costs
@@ -72,6 +74,8 @@ To reach Camel the agent needs the TUI's tools, so the TUI
starts its MCP server
Pick this when you already use a coding agent and want it inside the TUI, with
your subscription and its own tools
(it can also edit files and run commands, each asked for in a popup).
+image::jbang/camel-tui-ai-acp-claude-code.gif[Claude Code picked with Ctrl+P
in the AI panel answers a question about the running integration]
+
* xref:camel-jbang-tui-ai-agents.adoc#_using_a_coding_agent_acp[Using a coding
agent (ACP)]
== 3. Your agent drives the TUI (MCP)
@@ -83,6 +87,8 @@ draw on the screen to show you something, and edit the route
sources.
Pick this when the agent is where you do your work and you want it to see and
steer the running integrations.
+image::jbang/camel-tui-ai-agent-teaching.gif[An agent connected over MCP
explains the integration on the TUI screen]
+
* xref:camel-jbang-tui-ai-agents.adoc#_enabling_mcp[Enabling MCP] and
xref:camel-jbang-tui-ai-agents.adoc#_connecting_an_ai_agent[Connecting an AI
Agent]
=== One MCP server, two ways to start it
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-source-editor.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-source-editor.adoc
index 46c87141562f..52e6d2002f72 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-source-editor.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui-source-editor.adoc
@@ -119,6 +119,12 @@ what the AI wants to change, *d* shows the diff, *Enter*
applies it and *Esc* re
image::jbang/camel-tui-source-ai-edit-confirm.png[The change of the AI waits
for your confirmation]
+The whole loop with a local model, from orders that fail at runtime to the
fix: *Shift+F8* on the error, the
+question with the source around the line, the change and its diff, and dev
mode reloading the route (the time the
+model thinks is sped up):
+
+image::jbang/camel-tui-fix-with-ai.gif[Shift+F8 on a failing route: a local
model finds the mismatched endpoint, the change is confirmed with its diff, and
dev mode reloads the route]
+
A file the AI writes is checked like one you save, and a write that brings new
problems is refused, so the AI gets the
problems back and can try again. The view shows the file as the AI wrote it as
soon as you apply the change. With `/write live` in the AI panel, you can also
watch the AI type its change in the
editor; see
xref:camel-jbang-tui-ai-agents.adoc#_watching_the_ai_edit_live_mode[Watching
the AI edit].
