Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AgentCore Riferimento CLI
<a name="agentcore-cli-reference"></a>

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

**Topics**
+ [Ciclo di vita del progetto](#cli-project-lifecycle)
+ [Runtime di chiamata &amp;](#cli-invocation)
+ [Gestione delle risorse](#cli-resources)
+ [Set di dati di valutazione &amp;](#cli-evaluation)
+ [Pacchetti di &amp; configurazione di ottimizzazione](#cli-optimization)
+ [&amp;Impostazioni operative](#cli-operations)

## Ciclo di vita del progetto
<a name="cli-project-lifecycle"></a>

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

### agentcore crea
<a name="_agentcore_create"></a>

```
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
<a name="_agentcore_deploy"></a>

```
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
<a name="_agentcore_dev"></a>

```
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
<a name="_agentcore_package"></a>

```
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
<a name="_agentcore_export"></a>

```
agentcore export [options] [command]
```

Esporta un harness in un agente runtime di Strands.

### aggiornamento AgentCore
<a name="_agentcore_update"></a>

```
agentcore update [options] [command]
```

Verifica e installa gli aggiornamenti della CLI

 **Parametri** 

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

### convalida agentcore
<a name="_agentcore_validate"></a>

```
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 &amp;
<a name="cli-invocation"></a>

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

### invoca agentcore
<a name="_agentcore_invoke"></a>

```
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
<a name="_agentcore_exec"></a>

```
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
<a name="_agentcore_run"></a>

```
agentcore run [options] [command]
```

Esegui valutazioni, valutazioni in batch o consigli di ottimizzazione.

### registri di base dell'agente
<a name="_agentcore_logs"></a>

```
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
<a name="_agentcore_traces"></a>

```
agentcore traces|t [options] [command]
```

Visualizza e scarica le tracce degli agenti.

### status di agente principale
<a name="_agentcore_status"></a>

```
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
<a name="_agentcore_fetch"></a>

```
agentcore fetch [options] [command]
```

Recupera le informazioni di accesso per le risorse distribuite.

### vista AgentCore
<a name="_agentcore_view"></a>

```
agentcore view [options] [command]
```

Visualizza la cronologia e i dettagli del lavoro

## Gestione delle risorse
<a name="cli-resources"></a>

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

### agentcore add
<a name="_agentcore_add"></a>

```
agentcore add [options] [command] [subcommand]
```

Aggiungi risorse alla configurazione del progetto.

### agentcore remove
<a name="_agentcore_remove"></a>

```
agentcore remove [options] [command] [subcommand]
```

Rimuovi le risorse dalla configurazione del progetto.

### importazione di agentcore
<a name="_agentcore_import"></a>

```
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 &amp;
<a name="cli-evaluation"></a>

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

### valutazioni agentcore
<a name="_agentcore_evals"></a>

```
agentcore evals [options] [command]
```

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

### valutazioni in batch di AgentCore
<a name="_agentcore_batch_evaluations"></a>

```
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
<a name="_agentcore_dataset"></a>

```
agentcore dataset [options] [command]
```

Gestisci il contenuto e le versioni del set di dati

## Pacchetti di &amp; configurazione di ottimizzazione
<a name="cli-optimization"></a>

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

### pacchetto di configurazione agentcore
<a name="_agentcore_config_bundle"></a>

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

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

### agentcore promote
<a name="_agentcore_promote"></a>

```
agentcore promote [options] [command]
```

Promuovi le risorse

### archivio agentcore
<a name="_agentcore_archive"></a>

```
agentcore archive [options] [command]
```

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

## &amp;Impostazioni operative
<a name="cli-operations"></a>

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

### pausa agentcore
<a name="_agentcore_pause"></a>

```
agentcore pause [options] [command]
```

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

### curriculum agentcore
<a name="_agentcore_resume"></a>

```
agentcore resume [options] [command]
```

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

### agente core stop
<a name="_agentcore_stop"></a>

```
agentcore stop [options] [command]
```

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

### configurazione agentcore
<a name="_agentcore_config"></a>

```
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
<a name="_agentcore_telemetry"></a>

```
agentcore telemetry [options] [command]
```

Gestisci le preferenze anonime di analisi dell'utilizzo.

### feedback principale dell'agente
<a name="_agentcore_feedback"></a>

```
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]