awslabs / awslabs/agentcore-samples

Multiple issues preventing gateway tutorials from working end-to-end

Open
#1,922 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
3.4k
Forks
1.3k
Avg merge
1d 22h
Merged PRs (30d)
30

Description

### Description

Several issues in the `01-gateway/` tutorials prevent users from successfully completing the labs when
following the README instructions. These were found during end-to-end testing.

### Issues Found

**HIGH — Blocks users immediately:**

1. **CloudFormation Launch Stack URLs point to a private staging repo**
(`private-amazon-bedrock-agentcore-samples-staging`). External users clicking these buttons get 404
errors. Affects 5 READMEs (10 URLs total).

2. **Unpinned `fastmcp >= 3.2.4`** in 4 runtime apps floats to 3.4.6, which performs a PyPI version
check at startup and exceeds the gateway's 40-second sync timeout. Target sync fails with
`SYNCHRONIZE_UNSUCCESSFUL`.

**MEDIUM:**

3. **`databricks_currency_agent/app.yaml`** sets `MODEL_ID='claude-sonnet-4'` but `app.py` defaults to
`'databricks-claude-sonnet-4'` — one will point to a nonexistent endpoint.

4. **Duplicated paragraph** in `01-attach-targets/http/README.md` — same text block appears 3 times.

### Additional issues (not in this PR, documenting for tracking):

- `sensative-data-masking` directory is misspelled (should be `sensitive`)
- 13 references to `00-vpc-gateway-setup.md` which doesn't exist
- 9 references to `vpcegress/README.md` which doesn't exist
- 6+ dangling `.ipynb` links (no notebooks in repo)
- 14+ `aws bedrock-agentcore-control` commands missing `--region` flag
- Duplicate step headings in `02-mcp-target-synchronization/README.md`

### Steps to Reproduce

1. Clone the repo
2. Navigate to `01-gateway/00-optional-setup/`
4. Deploy the `labmcp` runtime → target sync timeout after 40s (fastmcp float)

### Proposed Fix

PR forthcoming with:
- Updated CloudFormation URLs to point to `awslabs/agentcore-samples` with correct path
- Pinned `fastmcp == 3.2.4` in all 4 affected `pyproject.toml` files
- Fixed `app.yaml` MODEL_ID to match `app.py` default
- Removed duplicated paragraph

### Environment

- AgentCore CLI: 0.25.0
- Python: 3.12+
- Tested: 2026-08

---

Contributor guide

Open the contributing guide

Research direction

Start in the 01-gateway/ tutorial READMEs and the four affected runtime pyproject.toml files, then inspect databricks_currency_agent/app.yaml and app.py plus 01-attach-targets/http/README.md. Verify the CloudFormation links, dependency pins, matching model IDs, and removal of the repeated paragraph by following the README deployment flow and confirming the gateway tutorials work end-to-end.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, python
Domain
cloud
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.