Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -31,10 +31,10 @@ These options are available on all commands:
## CLI Commands

- `create` - Create new AgentCore project
- `add` - Add resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
- `add` - Add resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy)
- `remove` - Remove resources (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine,
policy, all)
- `remove` - Remove resources (agent, memory, credential, evaluator, online-eval, gateway, gateway-target,
policy-engine, policy, all)
- `deploy` - Deploy infrastructure to AWS
- `status` - Check deployment status
- `dev` - Local development server (CodeZip: uvicorn with hot-reload; Container: Docker build + run with volume mount)
Expand DownExpand Up@@ -68,10 +68,10 @@ These options are available on all commands:

## Primitives Architecture

All resource types (agent, memory, identity, evaluator, online-eval, gateway, gateway-target, policy-engine, policy) are
modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle for
their resource type. Resources support config-driven tagging via `agentcore.json` and `mcp.json`, with tags flowing
through to deployed CloudFormation resources.
All resource types (agent, memory, credential, evaluator, online-eval, gateway, gateway-target, policy-engine, policy)
are modeled as **primitives** -- self-contained classes in `src/cli/primitives/` that own the full add/remove lifecycle
for their resource type. Resources support config-driven tagging via `agentcore.json`, with tags flowing through to
deployed CloudFormation resources.

Each primitive extends `BasePrimitive` and implements: `add()`, `remove()`, `previewRemove()`, `getRemovable()`,
`registerCommands()`, and `addScreen()`.
Expand All@@ -80,7 +80,7 @@ Current primitives:

- `AgentPrimitive` — agent creation (template + BYO), removal, credential resolution
- `MemoryPrimitive` — memory creation with strategies, removal
- `CredentialPrimitive` — credential/identity creation, .env management, removal
- `CredentialPrimitive` — credential creation, .env management, removal
- `EvaluatorPrimitive` — custom evaluator creation/removal with cross-reference validation
- `OnlineEvalConfigPrimitive` — online eval config creation/removal
- `GatewayPrimitive` — gateway creation/removal
Expand Down
44 changes: 32 additions & 12 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -60,17 +60,18 @@ agentcore invoke
| ------------------- | ----------------------------- |
| Strands Agents | AWS-native, streaming support |
| LangChain/LangGraph | Graph-based workflows |
| CrewAI | Multi-agent orchestration |
| Google ADK | Gemini models only |
| OpenAI Agents | OpenAI models only |

## Supported Model Providers

| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | ----------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | claude-sonnet-4-5-20250929-v1 |
| Anthropic | Yes | claude-sonnet-4-5-20250929 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4o |
| Provider | API Key Required | Default Model |
| -------------- | ------------------------- | -------------------------------------------- |
| Amazon Bedrock | No (uses AWS credentials) | us.anthropic.claude-sonnet-4-5-20250514-v1:0 |
| Anthropic | Yes | claude-sonnet-4-5-20250514 |
| Google Gemini | Yes | gemini-2.5-flash |
| OpenAI | Yes | gpt-4.1 |

## Commands

Expand All@@ -85,13 +86,22 @@ agentcore invoke

### Resource Management

| Command | Description |
| -------- | ------------------------------------------------- |
| `add` | Add agents, memory, identity, evaluators, targets |
| `remove` | Remove resources from project |
| Command | Description |
| -------- | ---------------------------------------------------- |
| `add` | Add agents, memory, credentials, evaluators, targets |
| `remove` | Remove resources from project |

> **Note**: Run `agentcore deploy` after `add` or `remove` to update resources in AWS.

### Observability

| Command | Description |
| ------------- | --------------------------------------- |
| `logs` | Stream or search agent runtime logs |
| `traces list` | List recent traces for a deployed agent |
| `traces get` | Download a trace to a JSON file |
| `status` | Show deployed resource details |

### Evaluations

| Command | Description |
Expand All@@ -102,6 +112,16 @@ agentcore invoke
| `evals history` | View past eval run results |
| `pause online-eval` | Pause a deployed online eval config |
| `resume online-eval` | Resume a paused online eval config |
| `logs evals` | Stream or search online eval logs |

### Utilities

| Command | Description |
| -------------- | ----------------------------------------- |
| `validate` | Validate configuration files |
| `package` | Package agent artifacts without deploying |
| `fetch access` | Fetch access info for deployed resources |
| `update` | Check for and install CLI updates |

## Project Structure

Expand DownExpand Up@@ -129,15 +149,15 @@ my-project/

Projects use JSON schema files in the `agentcore/` directory:

- `agentcore.json` - Agent specifications, memory, identity, evaluators, online evals
- `agentcore.json` - Agent specifications, memory, credentials, evaluators, online evals
- `deployed-state.json` - Runtime state in agentcore/.cli/ (auto-managed)
- `aws-targets.json` - Deployment targets (account, region)

## Capabilities

- **Runtime** - Managed execution environment for deployed agents
- **Memory** - Semantic, summarization, and user preference strategies
- **Identity** - Secure API key management via Secrets Manager
- **Credentials** - Secure API key management via Secrets Manager
- **Evaluations** - LLM-as-a-Judge for on-demand and continuous agent quality monitoring

## Documentation
Expand Down
Loading
Loading