@@ -4,13 +4,12 @@ AgentCore projects use JSON configuration files in the `agentcore/` directory.
44
55## Files Overview
66
7- | File | Purpose |
8- | --------------------- | ---------------------------------------------------------------- |
9- | ` agentcore.json ` | Project, agents, memories, credentials, evaluators, online evals |
10- | ` mcp.json ` | Gateways, gateway targets, and MCP tools |
11- | ` aws-targets.json ` | Deployment targets |
12- | ` deployed-state.json ` | Runtime state (auto-managed, do not edit) |
13- | ` .env.local ` | API keys for local development (gitignored) |
7+ | File | Purpose |
8+ | -------------------------- | ----------------------------------------------------------------------------- |
9+ | ` agentcore.json ` | Project, agents, memories, credentials, evaluators, online evals, gateways |
10+ | ` aws-targets.json ` | Deployment targets |
11+ | ` .cli/deployed-state.json ` | Runtime state (auto-managed, do not edit) |
12+ | ` .env.local ` | API keys for local development (gitignored) |
1413
1514---
1615
@@ -22,50 +21,29 @@ Main project configuration using a **flat resource model**. Agents, memories, an
2221{
2322 "name" : " MyProject"
2423 "version" : 1 ,
24+ "tags" : {
25+ "agentcore:created-by" : " agentcore-cli"
26+ "agentcore:project-name" : " MyProject"
27+ },
2528 "agents" : [
2629 {
2730 "type" : " AgentCoreRuntime"
2831 "name" : " MyAgent"
2932 "build" : " CodeZip"
3033 "entrypoint" : " main.py"
3134 "codeLocation" : " app/MyAgent/"
32- "runtimeVersion" : " PYTHON_3_12"
33- }
34- ],
35- "memories" : [
36- {
37- "type" : " AgentCoreMemory"
38- "name" : " MyMemory"
39- "eventExpiryDuration" : 30 ,
40- "strategies" : [{ "type" : " SEMANTIC"
41- }
42- ],
43- "credentials" : [
44- {
45- "type" : " ApiKeyCredentialProvider"
46- "name" : " OpenAI"
47- }
48- ],
49- "evaluators" : [
50- {
51- "type" : " CustomEvaluator"
52- "name" : " ResponseQuality"
53- "level" : " SESSION"
54- "config" : {
55- "llmAsAJudge" : {
56- "model" : " us.anthropic.claude-sonnet-4-5-20250929-v1:0"
57- "instructions" : " Evaluate the response quality. Context: {context}"
58- "ratingScale" : {
59- "numerical" : [
60- { "value" : 1 , "label" : " Poor" "definition" : " Fails to meet expectations"
61- { "value" : 5 , "label" : " Excellent" "definition" : " Far exceeds expectations"
62- ]
63- }
64- }
65- }
35+ "runtimeVersion" : " PYTHON_3_12"
36+ "networkMode" : " PUBLIC"
37+ "modelProvider" : " Bedrock"
38+ "protocol" : " HTTP"
6639 }
6740 ],
68- "onlineEvalConfigs" : []
41+ "memories" : [],
42+ "credentials" : [],
43+ "evaluators" : [],
44+ "onlineEvalConfigs" : [],
45+ "agentCoreGateways" : [],
46+ "policyEngines" : []
6947}
7048```
7149
@@ -81,8 +59,12 @@ Main project configuration using a **flat resource model**. Agents, memories, an
8159| ` credentials ` | Yes | Array of credential providers (API key or OAuth) |
8260| ` evaluators ` | Yes | Array of custom evaluator definitions |
8361| ` onlineEvalConfigs ` | Yes | Array of online eval configurations |
62+ | ` policyEngines ` | No | Array of policy engine configurations |
63+ | ` agentCoreGateways ` | No | Array of gateway definitions |
64+ | ` mcpRuntimeTools ` | No | Array of MCP runtime tool definitions |
65+ | ` unassignedTargets ` | No | Targets not yet assigned to a gateway |
8466
85- > Gateway configuration is stored separately in ` mcp.json ` . See [ mcp.json ] ( #mcpjson ) below.
67+ > Gateway configuration is in the ` agentCoreGateways ` field . See [ Gateways and MCP Tools ] ( #gateways-and-mcp-tools ) below.
8668
8769---
8870
@@ -204,9 +186,17 @@ on the next deployment.
204186| ` entrypoint ` | Yes | Entry file (e.g., ` main.py ` or ` main.py:handler ` ) |
205187| ` codeLocation ` | Yes | Directory containing agent code |
206188| ` runtimeVersion ` | Yes | Runtime version (see below) |
207- | ` networkMode ` | No | ` "PUBLIC" ` (default) or ` "PRIVATE" ` |
189+ | ` networkMode ` | No | ` "PUBLIC" ` (default) or ` "VPC" ` |
190+ | ` networkConfig ` | No | VPC configuration (subnets, security groups) |
191+ | ` protocol ` | No | ` "HTTP" ` (default), ` "MCP" ` , or ` "A2A" ` |
192+ | ` modelProvider ` | No | ` "Bedrock" ` , ` "Anthropic" ` , ` "OpenAI" ` , ` "Gemini" ` |
208193| ` envVars ` | No | Custom environment variables |
209194| ` instrumentation ` | No | OpenTelemetry settings |
195+ | ` authorizerType ` | No | ` "AWS_IAM" ` or ` "CUSTOM_JWT" ` |
196+ | ` authorizerConfiguration ` | No | JWT authorizer settings (for ` CUSTOM_JWT ` ) |
197+ | ` requestHeaderAllowlist ` | No | Headers to forward to the agent |
198+ | ` lifecycleConfiguration ` | No | Runtime session lifecycle settings (idle timeout, max lifetime) |
199+ | ` tags ` | No | Agent-level tags |
210200
211201### Runtime Versions
212202
@@ -217,6 +207,12 @@ on the next deployment.
217207- ` PYTHON_3_12 `
218208- ` PYTHON_3_13 `
219209
210+ ** Node.js:**
211+
212+ - ` NODE_18 `
213+ - ` NODE_20 `
214+ - ` NODE_22 `
215+
220216---
221217
222218## Memory Resource
@@ -235,7 +231,7 @@ on the next deployment.
235231| ` type ` | Yes | Always ` "AgentCoreMemory" ` |
236232| ` name ` | Yes | Memory name (1-48 chars) |
237233| ` eventExpiryDuration ` | Yes | Days until events expire (7-365) |
238- | ` strategies ` | Yes | Array of memory strategies (at least 1 ) |
234+ | ` strategies ` | Yes | Array of memory strategies (can be empty for short-term memory ) |
239235
240236### Memory Strategies
241237
@@ -244,6 +240,7 @@ on the next deployment.
244240| ` SEMANTIC ` | Vector-based similarity search for relevant context |
245241| ` SUMMARIZATION ` | Compressed conversation history |
246242| ` USER_PREFERENCE ` | Store user-specific preferences and settings |
243+ | ` EPISODIC ` | Capture and reflect on meaningful interaction episodes |
247244
248245Strategy configuration:
249246
@@ -312,7 +309,7 @@ See [Evaluations](evals.md) for the full guide.
312309 "description" : " Evaluate response quality"
313310 "config" : {
314311 "llmAsAJudge" : {
315- "model" : " us.anthropic.claude-sonnet-4-5-20250929 -v1:0"
312+ "model" : " us.anthropic.claude-sonnet-4-5-20250514 -v1:0"
316313 "instructions" : " Evaluate the response quality. Context: {context}"
317314 "ratingScale" : {
318315 "numerical" : [
@@ -382,12 +379,15 @@ See [Evaluations](evals.md) for the full guide.
382379
383380---
384381
385- ## mcp.json
382+ ## Gateways and MCP Tools
386383
387- Gateway and MCP tool configuration. Gateways, their targets, and standalone MCP runtime tools are defined here .
384+ Gateway and MCP tool configuration is part of ` agentcore.json ` (in the ` agentCoreGateways ` , ` mcpRuntimeTools ` , and ` unassignedTargets ` fields) .
388385
389386``` json
390387{
388+ "name" : " MyProject"
389+ "version" : 1 ,
390+ "agents" : [... ],
391391 "agentCoreGateways" : [
392392 {
393393 "name" : " MyGateway"
@@ -401,23 +401,15 @@ Gateway and MCP tool configuration. Gateways, their targets, and standalone MCP
401401 }
402402 ]
403403 }
404- ],
405- "unassignedTargets" : []
404+ ]
406405}
407406```
408407
409- ### Top-Level Fields
410-
411- | Field | Required | Description |
412- | ------------------- | -------- | ------------------------------------- |
413- | ` agentCoreGateways ` | Yes | Array of gateway definitions |
414- | ` unassignedTargets ` | No | Targets not yet assigned to a gateway |
415-
416408### Gateway
417409
418410| Field | Required | Description |
419411| ------------------------- | -------- | ------------------------------------------------------------ |
420- | ` name ` | Yes | Gateway name (alphanumeric, hyphens, 1-63 chars) |
412+ | ` name ` | Yes | Gateway name (alphanumeric, hyphens, 1-100 chars) |
421413| ` description ` | No | Gateway description |
422414| ` targets ` | Yes | Array of gateway targets |
423415| ` authorizerType ` | No | ` "NONE" ` (default), ` "AWS_IAM" ` , or ` "CUSTOM_JWT" ` |
@@ -442,9 +434,12 @@ Gateway and MCP tool configuration. Gateways, their targets, and standalone MCP
442434| Field | Required | Description |
443435| ----------------- | -------- | ---------------------------------------------------------------------- |
444436| ` discoveryUrl ` | Yes | OIDC discovery URL (must end with ` /.well-known/openid-configuration ` ) |
445- | ` allowedAudience ` | Yes | Array of allowed audience values |
446- | ` allowedClients ` | Yes | Array of allowed client IDs (at least 1) |
447- | ` allowedScopes ` | No | Array of allowed scopes |
437+ | ` allowedAudience ` | Cond. | Array of allowed audience values |
438+ | ` allowedClients ` | Cond. | Array of allowed client IDs |
439+ | ` allowedScopes ` | Cond. | Array of allowed scopes |
440+ | ` customClaims ` | Cond. | Custom claims for JWT validation |
441+
442+ > At least one of ` allowedAudience ` , ` allowedClients ` , ` allowedScopes ` , or ` customClaims ` must be provided.
448443
449444### Gateway Target
450445
@@ -479,7 +474,7 @@ implementations.
479474| Field | Required | Description |
480475| ----------------- | -------- | -------------------------------------------------------------------- |
481476| ` name ` | Yes | Target name |
482- | ` targetType ` | Yes | ` "mcpServer" ` or ` "lambda" ` |
477+ | ` targetType ` | Yes | ` "mcpServer" ` , ` "lambda" ` , ` "openApiSchema" ` , ` "smithyModel" ` , ` "apiGateway" ` , or ` "lambdaFunctionArn" ` |
483478| ` endpoint ` | Cond. | MCP server URL (required for external ` mcpServer ` targets) |
484479| ` compute ` | Cond. | Compute configuration (required for ` lambda ` and scaffolded targets) |
485480| ` toolDefinitions ` | Cond. | Array of tool definitions (required for ` lambda ` targets) |
0 commit comments