Skip to content

Add Spring AI integration documentation for Java SDK#4454

Open
donald-pinckney wants to merge 5 commits intomainfrom
docs/spring-ai-integration
Open

Add Spring AI integration documentation for Java SDK#4454
donald-pinckney wants to merge 5 commits intomainfrom
docs/spring-ai-integration

Conversation

@donald-pinckney
Copy link
Copy Markdown

@donald-pinckney donald-pinckney commented Apr 20, 2026

Summary

Documents the new temporal-spring-ai module that landed in sdk-java#2829.

  • Adds docs/develop/java/integrations/spring-ai.mdx with setup, chat model usage, tool types (Activity stubs, Nexus stubs, @SideEffectTool, plain tools), and optional vector store / embedding / MCP integrations.
  • Restructures docs/develop/java/integrations/index.mdx to split framework integrations from AI integrations (matching the Python SDK integrations layout).
  • Adds a Java SDK entry to the top-level docs/develop/integrations.mdx.
  • Adds the new page to sidebars.js.

Why

The Spring AI integration just merged to master on sdk-java. Java users following the Spring Boot path need a landing page that explains how to make Spring AI calls durable through Temporal, which tool annotations to use for determinism, and what optional features auto-configure.

Checklist

  • Follows STYLE.md guidelines
  • Frontmatter matches existing Java integration docs
  • Links to related documentation (Spring Boot integration, Plugin system, Nexus)
  • sidebars.js updated
  • No broken links

┆Attachments: EDU-6226 Add Spring AI integration documentation for Java SDK

Documents the new temporal-spring-ai module that makes Spring AI model
calls, tools, vector stores, embeddings, and MCP calls durable Temporal
primitives.
@donald-pinckney donald-pinckney requested a review from a team as a code owner April 20, 2026 17:04
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Apr 21, 2026 2:28pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 20, 2026

📖 Docs PR preview links

| Java | 17 |
| Spring Boot | 3.x |
| Spring AI | 1.1.0 |
| Temporal Java SDK | 1.35.0 |
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Note, 1.35.0 doesn't yet exist, but when it does, it will be the first version that has the plugin.

description: Build durable AI Workflows in Java with the Temporal Spring AI integration.
---

The [Temporal Spring AI integration](https://central.sonatype.com/artifact/io.temporal/temporal-spring-ai) lets you call [Spring AI](https://docs.spring.io/spring-ai/reference/) models, tools, vector stores, embeddings, and MCP servers from Temporal Workflows as durable Activities. Model calls and tool invocations are recorded in Workflow history, so they retry on failure and replay deterministically — without you having to change how you write Spring AI code.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Test this link after we do the Java release


Wrap `ActivityChatModel` in a `TemporalChatClient` to build prompts and register tools:

```java
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Consider using snipsync from a sample, which is the preferred style now.

description: Build durable AI Workflows in Java with the Temporal Spring AI integration.
---

The [Temporal Spring AI integration](https://central.sonatype.com/artifact/io.temporal/temporal-spring-ai) lets you call [Spring AI](https://docs.spring.io/spring-ai/reference/) models, tools, vector stores, embeddings, and MCP servers from Temporal Workflows as durable Activities. Model calls and tool invocations are recorded in Workflow history, so they retry on failure and replay deterministically — without you having to change how you write Spring AI code.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Would you consider Spring AI an agent framework? If so, maybe headline that.

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