@aws/agentcore 0.6.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -13
- package/dist/assets/README.md +2 -2
- package/dist/assets/__tests__/__snapshots__/assets.snapshot.test.ts.snap +4 -4
- package/dist/assets/agents/AGENTS.md +1 -1
- package/dist/assets/cdk/package.json +1 -1
- package/dist/cli/index.mjs +357 -346
- package/dist/lib/constants.d.ts +3 -1
- package/dist/lib/constants.d.ts.map +1 -1
- package/dist/lib/constants.js +8 -2
- package/dist/lib/constants.js.map +1 -1
- package/dist/lib/packaging/container.d.ts.map +1 -1
- package/dist/lib/packaging/container.js +2 -3
- package/dist/lib/packaging/container.js.map +1 -1
- package/dist/schema/schemas/agent-env.d.ts +1 -0
- package/dist/schema/schemas/agent-env.d.ts.map +1 -1
- package/dist/schema/schemas/agent-env.js +15 -0
- package/dist/schema/schemas/agent-env.js.map +1 -1
- package/dist/schema/schemas/agentcore-project.d.ts +49 -0
- package/dist/schema/schemas/agentcore-project.d.ts.map +1 -1
- package/dist/schema/schemas/agentcore-project.js +21 -1
- package/dist/schema/schemas/agentcore-project.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
<h1>AgentCore CLI</h1>
|
|
3
|
-
<
|
|
3
|
+
<p><strong>Create, develop, and deploy AI agents to Amazon Bedrock AgentCore</strong></p>
|
|
4
|
+
|
|
5
|
+
<p>
|
|
6
|
+
<a href="https://github.com/aws/agentcore-cli/actions/workflows/build-and-test.yml"><img src="https://img.shields.io/github/actions/workflow/status/aws/agentcore-cli/build-and-test.yml?branch=main&label=build" alt="Build Status"></a>
|
|
7
|
+
<a href="https://www.npmjs.com/package/@aws/agentcore"><img src="https://img.shields.io/npm/v/@aws/agentcore" alt="npm version"></a>
|
|
8
|
+
<a href="LICENSE"><img src="https://img.shields.io/github/license/aws/agentcore-cli" alt="License"></a>
|
|
9
|
+
</p>
|
|
4
10
|
</div>
|
|
5
11
|
|
|
6
12
|
## Overview
|
|
@@ -60,17 +66,18 @@ agentcore invoke
|
|
|
60
66
|
| ------------------- | ----------------------------- |
|
|
61
67
|
| Strands Agents | AWS-native, streaming support |
|
|
62
68
|
| LangChain/LangGraph | Graph-based workflows |
|
|
69
|
+
| CrewAI | Multi-agent orchestration |
|
|
63
70
|
| Google ADK | Gemini models only |
|
|
64
71
|
| OpenAI Agents | OpenAI models only |
|
|
65
72
|
|
|
66
73
|
## Supported Model Providers
|
|
67
74
|
|
|
68
|
-
| Provider | API Key Required | Default Model
|
|
69
|
-
| -------------- | ------------------------- |
|
|
70
|
-
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-
|
|
71
|
-
| Anthropic | Yes | claude-sonnet-4-5-
|
|
72
|
-
| Google Gemini | Yes | gemini-2.5-flash
|
|
73
|
-
| OpenAI | Yes | gpt-
|
|
75
|
+
| Provider | API Key Required | Default Model |
|
|
76
|
+
| -------------- | ------------------------- | -------------------------------------------- |
|
|
77
|
+
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
|
|
78
|
+
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
|
|
79
|
+
| Google Gemini | Yes | gemini-2.5-flash |
|
|
80
|
+
| OpenAI | Yes | gpt-4.1 |
|
|
74
81
|
|
|
75
82
|
## Commands
|
|
76
83
|
|
|
@@ -85,13 +92,22 @@ agentcore invoke
|
|
|
85
92
|
|
|
86
93
|
### Resource Management
|
|
87
94
|
|
|
88
|
-
| Command | Description
|
|
89
|
-
| -------- |
|
|
90
|
-
| `add` | Add agents, memory,
|
|
91
|
-
| `remove` | Remove resources from project
|
|
95
|
+
| Command | Description |
|
|
96
|
+
| -------- | ---------------------------------------------------- |
|
|
97
|
+
| `add` | Add agents, memory, credentials, evaluators, targets |
|
|
98
|
+
| `remove` | Remove resources from project |
|
|
92
99
|
|
|
93
100
|
> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.
|
|
94
101
|
|
|
102
|
+
### Observability
|
|
103
|
+
|
|
104
|
+
| Command | Description |
|
|
105
|
+
| ------------- | --------------------------------------- |
|
|
106
|
+
| `logs` | Stream or search agent runtime logs |
|
|
107
|
+
| `traces list` | List recent traces for a deployed agent |
|
|
108
|
+
| `traces get` | Download a trace to a JSON file |
|
|
109
|
+
| `status` | Show deployed resource details |
|
|
110
|
+
|
|
95
111
|
### Evaluations
|
|
96
112
|
|
|
97
113
|
| Command | Description |
|
|
@@ -102,6 +118,16 @@ agentcore invoke
|
|
|
102
118
|
| `evals history` | View past eval run results |
|
|
103
119
|
| `pause online-eval` | Pause a deployed online eval config |
|
|
104
120
|
| `resume online-eval` | Resume a paused online eval config |
|
|
121
|
+
| `logs evals` | Stream or search online eval logs |
|
|
122
|
+
|
|
123
|
+
### Utilities
|
|
124
|
+
|
|
125
|
+
| Command | Description |
|
|
126
|
+
| -------------- | ----------------------------------------- |
|
|
127
|
+
| `validate` | Validate configuration files |
|
|
128
|
+
| `package` | Package agent artifacts without deploying |
|
|
129
|
+
| `fetch access` | Fetch access info for deployed resources |
|
|
130
|
+
| `update` | Check for and install CLI updates |
|
|
105
131
|
|
|
106
132
|
## Project Structure
|
|
107
133
|
|
|
@@ -129,7 +155,7 @@ my-project/
|
|
|
129
155
|
|
|
130
156
|
Projects use JSON schema files in the `agentcore/` directory:
|
|
131
157
|
|
|
132
|
-
- `agentcore.json` - Agent specifications, memory,
|
|
158
|
+
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
|
|
133
159
|
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
|
|
134
160
|
- `aws-targets.json` - Deployment targets (account, region)
|
|
135
161
|
|
|
@@ -137,7 +163,7 @@ Projects use JSON schema files in the `agentcore/` directory:
|
|
|
137
163
|
|
|
138
164
|
- **Runtime** - Managed execution environment for deployed agents
|
|
139
165
|
- **Memory** - Semantic, summarization, and user preference strategies
|
|
140
|
-
- **
|
|
166
|
+
- **Credentials** - Secure API key management via Secrets Manager
|
|
141
167
|
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring
|
|
142
168
|
|
|
143
169
|
## Documentation
|
package/dist/assets/README.md
CHANGED
|
@@ -58,7 +58,7 @@ The project uses a **flat resource model** where agents, memories, and credentia
|
|
|
58
58
|
| Command | Description |
|
|
59
59
|
| -------------------- | ----------------------------------------------- |
|
|
60
60
|
| `agentcore create` | Create a new AgentCore project |
|
|
61
|
-
| `agentcore add` | Add resources (agent, memory,
|
|
61
|
+
| `agentcore add` | Add resources (agent, memory, credential, target) |
|
|
62
62
|
| `agentcore remove` | Remove resources |
|
|
63
63
|
| `agentcore dev` | Run agent locally |
|
|
64
64
|
| `agentcore deploy` | Deploy to AWS |
|
|
@@ -70,7 +70,7 @@ The project uses a **flat resource model** where agents, memories, and credentia
|
|
|
70
70
|
|
|
71
71
|
### Agent Types
|
|
72
72
|
|
|
73
|
-
- **Template agents**: Created from framework templates (Strands, LangChain_LangGraph, GoogleADK, OpenAIAgents)
|
|
73
|
+
- **Template agents**: Created from framework templates (Strands, LangChain_LangGraph, CrewAI, GoogleADK, OpenAIAgents)
|
|
74
74
|
- **BYO agents**: Bring your own code with `agentcore add agent --type byo`
|
|
75
75
|
|
|
76
76
|
## Documentation
|
|
@@ -358,7 +358,7 @@ exports[`Assets Directory Snapshots > CDK assets > cdk/cdk/package.json should m
|
|
|
358
358
|
},
|
|
359
359
|
"dependencies": {
|
|
360
360
|
"@aws/agentcore-cdk": "^0.1.0-alpha.1",
|
|
361
|
-
"aws-cdk-lib": "2.
|
|
361
|
+
"aws-cdk-lib": "2.248.0",
|
|
362
362
|
"constructs": "^10.0.0"
|
|
363
363
|
}
|
|
364
364
|
}
|
|
@@ -3915,7 +3915,7 @@ The project uses a **flat resource model** where agents, memories, and credentia
|
|
|
3915
3915
|
| Command | Description |
|
|
3916
3916
|
| -------------------- | ----------------------------------------------- |
|
|
3917
3917
|
| \`agentcore create\` | Create a new AgentCore project |
|
|
3918
|
-
| \`agentcore add\` | Add resources (agent, memory,
|
|
3918
|
+
| \`agentcore add\` | Add resources (agent, memory, credential, target) |
|
|
3919
3919
|
| \`agentcore remove\` | Remove resources |
|
|
3920
3920
|
| \`agentcore dev\` | Run agent locally |
|
|
3921
3921
|
| \`agentcore deploy\` | Deploy to AWS |
|
|
@@ -3927,7 +3927,7 @@ The project uses a **flat resource model** where agents, memories, and credentia
|
|
|
3927
3927
|
|
|
3928
3928
|
### Agent Types
|
|
3929
3929
|
|
|
3930
|
-
- **Template agents**: Created from framework templates (Strands, LangChain_LangGraph, GoogleADK, OpenAIAgents)
|
|
3930
|
+
- **Template agents**: Created from framework templates (Strands, LangChain_LangGraph, CrewAI, GoogleADK, OpenAIAgents)
|
|
3931
3931
|
- **BYO agents**: Bring your own code with \`agentcore add agent --type byo\`
|
|
3932
3932
|
|
|
3933
3933
|
## Documentation
|
|
@@ -4019,7 +4019,7 @@ file maps to a JSON config file and includes validation constraints as comments.
|
|
|
4019
4019
|
- **LangChain_LangGraph** - Works with Bedrock, Anthropic, OpenAI, Gemini
|
|
4020
4020
|
- **GoogleADK** - Gemini only
|
|
4021
4021
|
- **OpenAIAgents** - OpenAI only
|
|
4022
|
-
|
|
4022
|
+
|
|
4023
4023
|
|
|
4024
4024
|
### Specific Context
|
|
4025
4025
|
|
|
@@ -79,7 +79,7 @@ file maps to a JSON config file and includes validation constraints as comments.
|
|
|
79
79
|
- **LangChain_LangGraph** - Works with Bedrock, Anthropic, OpenAI, Gemini
|
|
80
80
|
- **GoogleADK** - Gemini only
|
|
81
81
|
- **OpenAIAgents** - OpenAI only
|
|
82
|
-
|
|
82
|
+
|
|
83
83
|
|
|
84
84
|
### Specific Context
|
|
85
85
|
|