Ciclo di vita del progetto Runtime di chiamata &Gestione delle risorse Set di dati di valutazione &Pacchetti di & configurazione di ottimizzazione &Impostazioni operative

AgentCore Riferimento CLI

Questo riferimento documenta le versioni pubbliche dell'interfaccia AgentCore CLI di Amazon Bedrock.

Argomenti

Ciclo di vita del progetto
Runtime di chiamata &
Gestione delle risorse
Set di dati di valutazione &
Pacchetti di & configurazione di ottimizzazione
&Impostazioni operative

Ciclo di vita del progetto

Auto-generated dalla @aws/agentcore v0.28.1: non modificare a mano.

agentcore crea


agentcore create [options]

Crea un nuovo progetto AgentCore

Parametri

--name <name>(opzionale): Nome della risorsa [non interattivo]
--project-name <name>(opzionale): Nome del progetto (inizia con una lettera, solo alfanumerico, massimo 23 caratteri) [non interattivo]
--no-agent(opzionale): Ignora la creazione dell'agente [non interattivo]
--defaults(opzionale): Crea un progetto Harness con le impostazioni predefinite (questa è l'impostazione predefinita) [non interattivo]
--build <type>(opzionale): Tipo di build: CodeZip o Contenitore (impostazione predefinita: CodeZip) [non interattivo]
--language <language>(opzionale): Lingua di destinazione: Python o TypeScript (impostazione predefinita: Python) [non interattiva]
--framework <framework>(opzionale): Framework per agenti (Strands, LangChain _LangGraph, GoogleADK, OpenAIAgents, VercelAI) [non interattivo]
--model-provider <provider>(opzionale): Fornitore di modelli (Bedrock, Anthropic, OpenAI, Gemini) [non interattivo]
--api-key <key>(opzionale): Chiave API per provider non Bedrock [non interattiva]
--memory <option>(opzionale): Opzione di memoria (nessuna, ShortTerm, longAndShortTerm) [non interattiva]
--protocol <protocol>(opzionale): Protocollo: HTTP, MCP, A2A, AGUI (impostazione predefinita: HTTP) [non interattivo]
--type <type>(opzionale): Tipo di agente: creazione o importazione (impostazione predefinita: creazione) [non interattivo]
--agent-id <id>(opzionale): ID agente Bedrock (richiesto per l'importazione di --type) [non interattivo]
--agent-alias-id <id>(opzionale): ID alias dell'agente Bedrock (richiesto per l'importazione di --type) [non interattivo]
--region <region>(opzionale): La AWS regione per Bedrock Agent (richiesta per l'importazione di --type) [non interattiva]
--network-mode <mode>(opzionale): Modalità di rete (PUBLIC, VPC) [non interattiva]
--subnets <ids>(opzionale): Comma-separated ID di sottorete (richiesti per la modalità VPC) [non interattivi]
--security-groups <ids>(opzionale): Comma-separated ID dei gruppi di sicurezza (richiesti per la modalità VPC) [non interattivi]
--vpc-id <id>(opzionale): ID VPC (richiesto per le build di container con modalità VPC) [non interattivo]
--idle-timeout <seconds>(opzionale): Timeout della sessione inattiva in secondi (60-28800) [non interattivo]
--max-lifetime <seconds>(opzionale): Durata massima dell'istanza in secondi (60-28800) [non interattivo]
--session-storage-mount-path <path>(opzionale): Percorso di montaggio assoluto per l'archiviazione del file system di sessione in /mnt (ad esempio,/) [non interattivo] mnt/data
--efs-access-point-arn <arn>(opzionale): punto di accesso EFS ARN (ripetibile, associato a --efs-mount-path) [non interattivo] (predefinito: [])
--efs-mount-path <path>(opzionale): percorso di montaggio EFS (ad esempio,/mnt/tools, associato a --efs-access-point-arn) [non interattivo] (predefinito: [])
--s3-access-point-arn <arn>(opzionale): Punto di accesso S3 Files ARN (ripetibile, associato a --s3-mount-path) [non interattivo] (predefinito: [])
--s3-mount-path <path>(opzionale): Percorso di montaggio dei file S3 (ad esempio,/mnt/datasets, associato a --s3-access-point-arn) [non interattivo] (predefinito: [])
--with-config-bundle(opzionale): Crea un pacchetto di configurazione collegato al modello dell'agente [non interattivo]
--output-dir <dir>(opzionale): Directory di output (impostazione predefinita: directory corrente) [non interattiva]
--skip-git(opzionale): Salta l'inizializzazione del repository git [non interattivo]
--skip-python-setup(opzionale): Salta la configurazione dell'ambiente virtuale Python [non interattivo]
--skip-install(opzionale): Salta l'installazione di tutte le dipendenze (npm install, uv sync) [non interattiva]
--dry-run(opzionale): Visualizza l'anteprima di ciò che verrebbe creato senza apportare modifiche [non interattivo]
--json(opzionale): Uscita come JSON [non interattivo]
--model-id <id>(opzionale): ID del modello per l'imbracatura [non interattivo]
--api-key-arn <arn>(opzionale): Chiave API ARN per fornitori di cablaggi non Bedrock [non interattivo]
--api-base <url>(opzionale): URL di base per l'endpoint API del fornitore di modelli di harness (lite_llm) [non interattivo]
--additional-params <json>(opzionale): Provider-specific utilizza i parametri come oggetto JSON (lite_llm) [non interattivo]
--no-harness-memory(opzionale): Disattiva la memoria per il cablaggio (impostazione predefinita) [non interattivo]
--max-iterations <n>(opzionale): Numero massimo di iterazioni del ciclo degli agenti (harness) [non interattivo]
--max-tokens <n>(opzionale): Numero massimo di token per iterazione (harness) [non interattivo]
--timeout <seconds>(opzionale): Durata massima dell'esecuzione in secondi (harness) [non interattivo]
--truncation-strategy <strategy>(opzionale): Strategia di troncamento: sliding_window o summarization (harness) [non interattiva]
--container <uri-or-path>(opzionale): URI dell'immagine del contenitore o percorso del Dockerfile (harness) [non interattivo]

distribuzione del core dell'agente


agentcore deploy|dp [options]

Implementa l'infrastruttura del progetto tramite CDK. AWS

Parametri

--target <target>(opzionale): Nome della destinazione di distribuzione (predefinito: «predefinito») [non interattivo]
-y, --yes(opzionale): Auto-confirm prompt, leggi le credenziali da env [non-interactive]
-v, --verbose(opzionale): Mostra eventi di distribuzione a livello di risorsa [non interattivo]
--json(opzionale): Uscita come JSON [non interattivo]
--dry-run(opzionale): Visualizza l'anteprima della distribuzione senza distribuzione [non interattivo]
--diff(opzionale): Mostra CDK diff senza implementare [non interattivo]

agentcore dev


agentcore dev|d [options] [prompt]

Avvia il server di sviluppo locale o richiama un agente localmente.

Parametri

prompt: Invia un prompt a un server di sviluppo in esecuzione [non interattivo]
-p, --port <port>(opzionale): Porta per il server di sviluppo. Utilizzata così com'è se impostata in modo esplicito; l'impostazione predefinita è compensata dall'indice di runtime nei progetti multi-runtime. (impostazione predefinita: «8080")
-r, --runtime <name>(opzionale): Runtime da eseguire o richiamare (obbligatorio in caso di più runtime)
-s, --stream(opzionale): Risposta in streaming quando si richiama [non interattivo]
-l, --logs(opzionale): Esegui il server di sviluppo con i log su stdout [non interattivo]
--exec(opzionale): Esegue un comando shell nel contenitore dev in esecuzione (solo agenti Container) [non interattivo]
--tool <name>(opzionale): nome dello strumento MCP (utilizzato con il prompt «call-tool») [non interattivo]
--input <json>(opzionale): Argomenti dello strumento MCP come JSON (usato con --tool) [non interattivo]
--skip-deploy(opzionale): Ignora la distribuzione automatica delle risorse prima di avviare il server di sviluppo
-H, --header <header>(opzionale): Intestazione personalizzata da inoltrare all'agente (formato: «Nome: valore», ripetibile) [non interattivo] (predefinito: [])
-b, --no-browser(opzionale): Usa la TUI del terminale invece dell'interfaccia utente di chat basata sul web
--no-traces(opzionale): Disabilita la raccolta di tracce OTEL locali

pacchetto agentcore


agentcore package|pkg [options]

Gli artefatti dell'agente di pacchetto non vengono distribuiti.

Parametri

-d, --directory <path>(opzionale): Cartella del progetto contenente la configurazione di agentcore
-r, --runtime <name>(opzionale): Impacchettizza solo il runtime specificato

agentcore export


agentcore export [options] [command]

Esporta un harness in un agente runtime di Strands.

aggiornamento AgentCore


agentcore update [options] [command]

Verifica e installa gli aggiornamenti della CLI

Parametri

-c, --check(opzionale): Verifica la disponibilità di aggiornamenti senza installarli

convalida agentcore


agentcore validate [options]

Convalida i file agentcore/ config.

Parametri

-d, --directory <path>(opzionale): Cartella del progetto contenente la configurazione di agentcore
--json(opzionale): Uscita come JSON [non interattivo]

Runtime di chiamata &

Auto-generated dalla @aws/agentcore v0.28.1: non modificare a mano.

invoca agentcore


agentcore invoke|i [options] [prompt]

Richiama un endpoint agente distribuito.

Parametri

prompt: Richiesta di invio all'agente. Accetta anche piped stdin quando non viene fornito alcun prompt e stdin non è un TTY [non interattivo]
--prompt <text>(opzionale): Richiesta da inviare all'agente [non interattiva]
--prompt-file <path>(opzionale): Leggi il prompt da un file (per payload lunghi o strutturati che superano i limiti di shell arg) [non interattivo]
--runtime <name>(opzionale): Seleziona un runtime specifico [non interattivo]
--gateway <name>(opzionale): Richiama tramite un gateway [non interattivo]
--gateway-target-name <name>(opzionale): Target di runtime HTTP sul gateway [non interattivo]
--target <name>(opzionale): Seleziona la destinazione di distribuzione [non interattiva]
--session-id <id>(opzionale): Usa un ID di sessione specifico per la continuità della conversazione
--user-id <id>(opzionale): ID utente per l'invocazione in fase di esecuzione (impostazione predefinita: «default-user»)
--api-base <url>(opzionale): L'URL di base dell'API LiteLLM sostituisce le invocazioni di Harness. Disponibile solo in modalità non interattiva. lite_llm
--additional-params <json>(opzionale): I parametri LiteLLM aggiuntivi, come oggetto JSON, per le invocazioni di Harness. Disponibile solo in modalità non interattiva. lite_llm
--payment-user-id <id>(opzionale): End-user/wallet-owner identità (il valore predefinito è --user-id)
--payment-instrument-id <id>(opzionale): ID dello strumento di pagamento (portafoglio)
--payment-session-id <id>(opzionale): ID della sessione di pagamento per il monitoraggio del budget
--auto-session(opzionale): Auto-create/reuse una sessione di pagamento per i test
--json(opzionale): Uscita come JSON
--stream(opzionale): Risposta in streaming in tempo reale
--tool <name>(opzionale): Nome dello strumento MCP (da utilizzare con il prompt «call-tool»)
--input <json>(opzionale): Argomenti dello strumento MCP in formato JSON (da utilizzare con --tool)
--exec(opzionale): Esegue un comando di shell nel contenitore di runtime
--timeout <seconds>(opzionale): Timeout in secondi per i comandi --exec
-H, --header <header>(opzionale): Intestazione personalizzata «Nome: Valore» (ripetibile)
--bearer-token <token>(opzionale): Token al portatore per l'autenticazione CUSTOM_JWT (bypassa SIGv4)
--harness <name>(opzionale): Seleziona l'imbracatura specifica da richiamare
--harness-arn <arn>(opzionale): Richiama un cablaggio tramite ARN (nessun progetto richiesto)
--region <region>(opzionale): La AWS regione (richiesta con --harness-arn)
--verbose(opzionale): Stampa eventi JSON in streaming dettagliati
--model-id <id>(opzionale): Sostituisci modello
--model-provider <provider>(opzionale): Il fornitore del modello. Valori validi: bedrock, open_ai o gemini.
--api-key-arn <arn>(opzionale): Chiave API ARN per open_ai/gemini
--tools <tools>(opzionale): Sostituisci gli strumenti (separati da virgole)
--allowed-tools <tools>(opzionale): Sostituisci gli strumenti consentiti (separati da virgole)
--skills <paths>(opzionale): Competenze (percorsi separati da virgole)
--system-prompt <text>(opzionale): Ignora il prompt del sistema
--actor-id <id>(opzionale): Sostituisci l'ID del fattore di memoria
--max-iterations <n>(opzionale): Sostituisci il numero massimo di iterazioni
--max-tokens <n>(opzionale): Sostituisci il numero massimo di token
--harness-timeout <seconds>(opzionale): Sostituisci i secondi di timeout

agente core exec


agentcore exec [options] [command...]

Apri una shell interattiva o esegui un comando one-shot in un contenitore di agenti distribuito.

Parametri

command: Comando da eseguire (modalità one-shot, non interattiva)
--it(opzionale): Aprire una sessione PTY shell interattiva
--runtime <name|arn>(opzionale): Nome dell'agente di destinazione o ARN di runtime (salta il selettore dell'agente)
--harness <name|arn>(opzionale): Nome del cablaggio di destinazione o ARN del cablaggio (salta il selettore dell'agente)
--session-id <id>(opzionale): Aggiungi a una sessione/VM di runtime specifica
--shell-id <id>(opzionale): Riconnettiti a una shell esistente
--region <region>(opzionale): La AWS regione
--bearer-token <token>(opzionale): Token al portatore per l'autenticazione CUSTOM_JWT (salta SIGv4)
--target <name>(opzionale): Nome della destinazione di distribuzione (da agentcore.json)
--timeout <seconds>(opzionale): Timeout in secondi per i comandi one-shot
--json(opzionale): Risultato dell'output in formato JSON (solo modalità one-shot, incompatibile con --it)

agentcore run


agentcore run [options] [command]

Esegui valutazioni, valutazioni in batch o consigli di ottimizzazione.

registri di base dell'agente


agentcore logs|l [options] [command]

Registri di runtime degli agenti di streaming o ricerca.

Parametri

--runtime <name>(opzionale): Seleziona un runtime specifico
--since <time>(opzionale): Ora di inizio: il valore predefinito è 1 ora fa in modalità di ricerca (ad esempio, «1h», «30m», «2d», ISO 8601)
--until <time>(opzionale): Ora di fine: l'impostazione predefinita è ora in modalità di ricerca (ad esempio, «adesso», ISO 8601)
--level <level>(opzionale): Filtra per livello di registro (error, warn, info, debug)
-n, --limit <count>(opzionale): Numero massimo di righe di registro da restituire
--query <text>(opzionale): Server-side filtro di testo
--json(opzionale): Uscita come linee JSON

tracce del core dell'agente


agentcore traces|t [options] [command]

Visualizza e scarica le tracce degli agenti.

status di agente principale


agentcore status|s [options]

Mostra i dettagli e lo stato delle risorse distribuite.

Parametri

--runtime-id <id>(opzionale): Cerca un runtime specifico per ID
--target <name>(opzionale): Seleziona la destinazione di distribuzione
--type <type>(opzionale): Filtra per tipo di risorsa (agent, runtime-endpoint, memory, credential, gateway, evaluator, online-eval, payment, policy-engine, policy, config-bundle, dataset, knowledge-base, harness)
--state <state>(opzionale): Filtra per stato di distribuzione (distribuito, solo locale, in sospeso di rimozione)
--runtime <name>(opzionale): Filtrare in base a un runtime specifico
--name <name>(opzionale): Mostra i dettagli di una singola risorsa per nome (knowledge-base)
--json(opzionale): Uscita come JSON

agentcore fetch


agentcore fetch [options] [command]

Recupera le informazioni di accesso per le risorse distribuite.

vista AgentCore


agentcore view [options] [command]

Visualizza la cronologia e i dettagli del lavoro

Gestione delle risorse

Auto-generated dalla @aws/agentcore v0.28.1: non modificare a mano.

agentcore add


agentcore add [options] [command] [subcommand]

Aggiungi risorse alla configurazione del progetto.

agentcore remove


agentcore remove [options] [command] [subcommand]

Rimuovi le risorse dalla configurazione del progetto.

importazione di agentcore


agentcore import [options] [command]

Importa un runtime, una memoria o un toolkit iniziale in questo progetto.

Parametri

--source <path>(opzionale): Percorso del file di configurazione .bedrock_agentcore.yaml
--target <target>(opzionale): Nome del target di distribuzione (necessario solo se il progetto ha più destinazioni)
-y, --yes(opzionale): Auto-confirm istruzioni

Set di dati di valutazione &

Auto-generated dalla @aws/agentcore v0.28.1: non modificare a mano.

valutazioni agentcore


agentcore evals [options] [command]

Visualizza i risultati di eval e batch eval salvati delle esecuzioni precedenti.

valutazioni in batch di AgentCore


agentcore batch-evaluations [options] [command] <id>

Visualizza i lavori di valutazione in batch e i relativi risultati.

Parametri

id: ID del processo di valutazione in batch da visualizzare
--json(opzionale): Uscita come JSON

set di dati agentcore


agentcore dataset [options] [command]

Gestisci il contenuto e le versioni del set di dati

Pacchetti di & configurazione di ottimizzazione

Auto-generated dalla @aws/agentcore v0.28.1: non modificare manualmente.

pacchetto di configurazione agentcore


agentcore config-bundle|cb [options] [command]

Gestisci i bundle di configurazione (usa il nome del pacchetto da agentcore.json, non l'ID)

agentcore promote


agentcore promote [options] [command]

Promuovi le risorse

archivio agentcore


agentcore archive [options] [command]

Archivia (elimina) una valutazione o una raccomandazione in batch sul servizio e cancella la cronologia locale.

&Impostazioni operative

Auto-generated dalla @aws/agentcore v0.28.1: non modificare a mano.

pausa agentcore


agentcore pause [options] [command]

Metti in pausa una risorsa distribuita (eval config online, test). A/B

curriculum agentcore


agentcore resume [options] [command]

Riprendi una risorsa in pausa (eval config online, test). A/B

agente core stop


agentcore stop [options] [command]

Interrompe una valutazione o A/B un test del batch in esecuzione.

configurazione agentcore


agentcore config [options] [key] [value]

Modifica le impostazioni di configurazione globali, ad esempio lo stato di disattivazione della telemetria

Parametri

key: Chiave di configurazione in notazione a punti (ad esempio, telemetry.enabled)
value: Valore da impostare

telemetria AgentCore


agentcore telemetry [options] [command]

Gestisci le preferenze anonime di analisi dell'utilizzo.

feedback principale dell'agente


agentcore feedback [options] [message]

Invia feedback sulla AgentCore CLI al team.

Parametri

message: Messaggio di feedback [non interattivo]
--screenshot <path>(opzionale): Percorso di una schermata PNG o JPG (max 100 MB) [non interattivo]
--json(opzionale): Risultato dell'output come JSON [non interattivo]

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Guida alla migrazione del registro

AgentCore Riferimento Python SDK

AgentCore Riferimento CLI

Argomenti

Ciclo di vita del progetto

agentcore crea

distribuzione del core dell'agente

agentcore dev

pacchetto agentcore

agentcore export

aggiornamento AgentCore

convalida agentcore

Runtime di chiamata &amp;

invoca agentcore

agente core exec

agentcore run

registri di base dell'agente

tracce del core dell'agente

status di agente principale

agentcore fetch

vista AgentCore

Gestione delle risorse

agentcore add

agentcore remove

importazione di agentcore

Set di dati di valutazione &amp;

valutazioni agentcore

valutazioni in batch di AgentCore

set di dati agentcore

Pacchetti di &amp; configurazione di ottimizzazione

pacchetto di configurazione agentcore

agentcore promote

archivio agentcore

&amp;Impostazioni operative

pausa agentcore

curriculum agentcore

agente core stop

configurazione agentcore

telemetria AgentCore

feedback principale dell'agente

Runtime di chiamata &

Set di dati di valutazione &

Pacchetti di & configurazione di ottimizzazione

&Impostazioni operative