@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 CHANGED
@@ -1,6 +1,12 @@
1
1
  <div align="center">
2
2
  <h1>AgentCore CLI</h1>
3
- <h2>Create, develop, and deploy AI agents to Amazon Bedrock AgentCore</h2>
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-20250929-v1 |
71
- | Anthropic | Yes | claude-sonnet-4-5-20250929 |
72
- | Google Gemini | Yes | gemini-2.5-flash |
73
- | OpenAI | Yes | gpt-4o |
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, identity, evaluators, targets |
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, identity, evaluators, online evals
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
- - **Identity** - Secure API key management via Secrets Manager
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
@@ -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, identity, target) |
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.243.0",
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, identity, target) |
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
- - **AutoGen** - Works with Bedrock, Anthropic, OpenAI, Gemini
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
- - **AutoGen** - Works with Bedrock, Anthropic, OpenAI, Gemini
82
+
83
83
 
84
84
  ### Specific Context
85
85
 
@@ -24,7 +24,7 @@
24
24
  },
25
25
  "dependencies": {
26
26
  "@aws/agentcore-cdk": "^0.1.0-alpha.1",
27
- "aws-cdk-lib": "2.243.0",
27
+ "aws-cdk-lib": "2.248.0",
28
28
  "constructs": "^10.0.0"
29
29
  }
30
30
  }