Skip to content

docs: register AI tool objects with the AI framework - #6710

Draft
tomivirkki wants to merge 4 commits into
mainfrom
docs/ai-tools-with-framework
Draft

tomivirkki wants to merge 4 commits into
mainfrom
docs/ai-tools-with-framework

Conversation

@tomivirkki

Copy link
Copy Markdown
Member

Summary

tomivirkki and others added 2 commits November 19, 2026 14:25
The withTools() method of the AI orchestrator is deprecated. The AI
pages now register tool objects with Spring AI or LangChain4j instead,
and the testing guide adds the chat's tool through a controller.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
The tool objects of a request are deprecated together with
withTools(), so the custom provider section no longer lists them.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Preview Deployment

This PR has been deployed for preview.

URL: https://docs-preview-pr-6710.fly.dev

Changed pages

Added content is highlighted in green; removed content is marked in red on each page.

Built from 21a802e

@vaadin-review-bot vaadin-review-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed the changes — left 4 comments.

Finding
⚠️ The LangChain4j customizer constructor doesn't exist in the flow-components source
⚠️ withTools() is called deprecated, but it isn't deprecated in the source yet
⚠️ The MCP note on LLM Providers now contradicts the new AI-service description
💬 "Configure the error handling of the framework" gives the reader nothing to act on


Every conversation that runs through the same [classname]`ChatClient` or provider calls the same tool objects. When a tool works with the state of one view, such as its components, create the client or the provider for that view.

[methodname]`withTools()` on the orchestrator builder, and after [methodname]`reconnect()`, takes the same tool objects, but it's deprecated. Register the tool objects with the AI framework instead.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ withTools() is called deprecated, but it isn't deprecated in the source yet

[methodname]withTools() on the orchestrator builder, and after [methodname]reconnect(), takes the same tool objects, but it's deprecated.

AIOrchestrator.Builder.withTools(), Reconnector.withTools() and LLMProvider.LLMRequest.tools() carry no @Deprecated annotation in flow-components main. The whole PR rests on vaadin/flow-components#10736, which hasn't merged. Hold the docs change until it does, or the page tells readers to migrate away from an API that the IDE still shows as current.

tool-calling.adoc:56 · accuracy

tomivirkki and others added 2 commits November 19, 2026 14:49
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@tomivirkki
tomivirkki marked this pull request as draft November 19, 2026 12:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants