Skip to content

docs: Serverless Workers on AgentCore Runtime - #5289

Merged
lennessyy merged 84 commits into
mainfrom
docs/agentcore-serverless-workers
Sep 17, 2026
Merged

lennessyy merged 84 commits into
mainfrom
docs/agentcore-serverless-workers

Conversation

@lennessyy

@lennessyy lennessyy commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

What changed

  • Add concept guidance for Serverless Workers on Amazon Bedrock AgentCore Runtime.
  • Add the Python SDK Worker implementation page, including Runtime handler, idle detection, and graceful shutdown.
  • Add an end-to-end production deployment guide based on the Python Strands AgentCore sample.
  • Document the Worker Versioning mapping between named AgentCore Runtime endpoints and Temporal Worker Deployment Versions.
  • Document AgentCore Runtime lifecycle behavior and the shared AWS Lambda event-driven scaling model.
  • Add AgentCore Runtime to Serverless Workers navigation and overview pages.

Validation

  • yarn build
  • vale --config .vale-ci.ini on all changed documentation files
  • yarn check:orphans
  • Targeted internal link and anchor check for the new deployment page

The full-repository link check also ran. It encountered unrelated existing external-link and JavaScript parser failures. The new page internal links and anchors pass.

@vercel

vercel Bot commented Sep 9, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
temporal-documentation Ready Ready Preview Sep 17, 2026 6:56pm UTC

Request Review

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

@lennessyy
lennessyy marked this pull request as ready for review September 16, 2026 18:35
@lennessyy
lennessyy requested a review from a team as a code owner September 16, 2026 18:35

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4f8ea81475

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

| AWS Lambda | Temporal assumes an IAM role in your AWS account to invoke a Lambda function. |
| GCP Cloud Run | Temporal scales a Cloud Run [Worker Pool](https://cloud.google.com/run/docs/resource-model#worker-pools) through the Cloud Run admin API. A Worker Pool is its own Cloud Run resource type, distinct from a Service or a Job. |
| Provider | Description |
| ------------------------------ | ----------- |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Update the remaining feature-level provider summaries

Adding AgentCore as the third provider here leaves docs/evaluate/features/serverless-workers/index.mdx describing and listing only AWS Lambda and GCP Cloud Run in its introduction, lifecycle comparison, supported-provider table, and SDK table; this page’s autoscaling index at lines 151-154 also still links only those two providers. Update those summaries and tables so readers entering through the Evaluate page or autoscaling section can discover the new AgentCore support.

AGENTS.md reference: AGENTS.md:L237-L243

Useful? React with 👍 / 👎.

capacity, it invokes an AgentCore Runtime endpoint. The Runtime starts a Worker, which connects to the Temporal Service
and polls its Task Queue.

## How Temporal and AgentCore work together {/* #how-temporal-and-agentcore-work-together */}

@ericbriffa ericbriffa Sep 16, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

@bchav i expect we will use this table in customer calls, so it would be good to add more detail on some of the agent core features that the harness can control today, like Memory and code interpreter, where the ID can be orchestrated from the harness and decoupled from the runtime session ID, and therefore not affected by our current worker <> runtime session affinity issues.

lets meet to bottom out on the technical aspects of this to ensure we are not missing any value prop today.

lennessyy and others added 5 commits September 16, 2026 12:01
…less-workers

# Conflicts:
#	docs/develop/python/workers/serverless-workers/index.mdx
#	docs/encyclopedia/workers/serverless-workers/index.mdx
#	docs/evaluate/features/serverless-workers/index.mdx
#	docs/production-deployment/worker-deployments/serverless-workers/index.mdx
…s' into docs/agentcore-serverless-workers

# Conflicts:
#	docs/production-deployment/worker-deployments/serverless-workers/index.mdx
@@ -0,0 +1,280 @@
---
id: agentcore
title: Serverless Workers on Amazon Bedrock AgentCore Runtime - Python SDK

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.

Suggested change
title: Serverless Workers on Amazon Bedrock AgentCore Runtime - Python SDK
title: Serverless Workers on Amazon Bedrock AgentCore Runtime

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.

It's fine in light mode, but I was wondering if we have a light version of this too.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants