# Esporta il cablaggio in codice
<a name="harness-export"></a>

Export harness to code richiede una configurazione di harness gestita e genera l'agente equivalente come codice sorgente Python modificabile utilizzando il framework Strands. L'agente generato è un normale agente AgentCore di runtime: sei il proprietario del codice, puoi modificarlo liberamente e distribuirlo come qualsiasi altro agente. L'agente generato rispecchia il modello, gli strumenti, le competenze, la memoria, i limiti di esecuzione e i supporti del file system dell'harness.

## Quando usare Export
<a name="_when_to_use_export"></a>

Usa l'esportazione quando hai un'imbracatura da lavoro e desideri:
+  **Personalizza oltre a quanto consentito dalla configurazione dell'harness**: aggiungi una logica di strumento personalizzata, modifica il loop dell'agente middleware/hooks, inietta o integra librerie non esposte dall'harness
+  **Gestisci il codice**: passa da una configurazione dichiarativa al codice sorgente che controlli, rivedi e modifichi come il resto dell'applicazione.
+  **Sviluppa un prototipo**: inizia velocemente con un cablaggio, quindi esporta quando sei pronto a investire in un agente gestito manualmente.

Se la configurazione del cablaggio soddisfa già tutto ciò di cui hai bisogno, non devi esportare: continua a utilizzarla come cablaggio.

## Cosa è supportato oggi
<a name="_what_is_supported_today"></a>
+  **Framework** - Strands, con altri framework come Claude Agents SDK in arrivo
+  **Linguaggio**: solo Python
+  **Tipi di build** - CodeZip (impostazione predefinita) e contenitore

Sfrutta le funzionalità incluse nell'agente generato:
+ Fornitore e configurazione del modello (Bedrock, OpenAI, Gemini, inclusi ID del modello e riferimenti alle chiavi API)
+ Strumenti: strumenti MCP remoti, gateway, strumenti funzionali in linea, AgentCore browser, interprete di codice, strumenti integrati AgentCore `shell` `file_operations`
+ Memoria
+ Limiti di esecuzione
+ Troncamento della conversazione
+ Competenze (Path, S3, Git)
+ Supporti di file system (storage di sessione, EFS, S3) per cablaggi VPC
+ Configurazione dell'autorizzatore

## Utilizzo della CLI
<a name="_cli_usage"></a>

### Sintassi dei comandi
<a name="_command_syntax"></a>

**Example**  

```
agentcore export harness --arn <arn> [options]
```

### Opzioni
<a name="_options"></a>


| Flag | Description | Predefinita | 
| --- | --- | --- | 
|  `--arn <arn>`  | ARN dell'harness da esportare (da utilizzare quando si esporta un harness creato al di fuori del progetto CLI corrente) |  `arn`o richiesto `name` | 
|  `--name <name>`  | Nome del cablaggio da esportare (da utilizzare quando si esporta un cablaggio creato nello stesso progetto CLI) |  `arn`o `name` richiesto | 
|  `--target-agent-name <name>`  | Nome dell'agente di runtime generato |  `<harnessName>Agent`  | 
|  `--build <type>`  | Tipo di build: `CodeZip` o `Container`  |  `CodeZip`  | 
|  `--json`  | Emetti i risultati in formato JSON | False | 

### Esempi
<a name="_examples"></a>

Esportazione di base con impostazioni predefinite:

**Example**  

```
# Export harness with ARN - generates MyHarnessAgent using CodeZip
agentcore export harness --arn arn:aws:bedrock-agentcore:us-east-1:123456789012:harness/MyHarness
# Export harness created within CLI project - generates MyHarnessAgent using CodeZip
agentcore export harness --name MyHarness
# Export with a custom agent name
agentcore export harness --name MyHarness --target-agent-name MyProductionAgent
# Export as a Container build (generates Dockerfile)
agentcore export harness --name MyHarness --build Container
```
Esegui `agentcore export harness` senza `--name` avviare la procedura guidata di esportazione interattiva.  

1. Se il progetto ha più di un cablaggio, selezionate il cablaggio da esportare. (Con un solo cablaggio, il wizard salta questo passaggio.)  
![Selezionate il cablaggio da esportare](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/images/tui/harness-export-01-select.png)

1. Immettete un nome per l'agente di runtime generato o accettate quello predefinito`<harness>Agent`.  
![Assegna un nome all'agente runtime generato](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/images/tui/harness-export-02-name.png)

1. Scegli il tipo di build: **CodeZip**(pacchetto sorgente Python come zip, impostazione predefinita) o **Container** (crea un'immagine Docker tramite ECR e). CodeBuild  
![Seleziona il tipo di build](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/images/tui/harness-export-03-build.png)

1. Rivedi la configurazione di esportazione e conferma.  
![Rivedi e conferma l'esportazione](http://docs.aws.amazon.com/it_it/bedrock-agentcore/latest/devguide/images/tui/harness-export-04-confirm.png)
Dopo l'esportazione, esamina`EXPORT_NOTES.md`, quindi `agentcore deploy` esegui per distribuire l'agente generato.

### Dopo l'esportazione
<a name="_after_export"></a>

Distribuisci l'agente di runtime generato utilizzando la AgentCore CLI.

**Example**  

```
agentcore deploy
```

L'agente esportato viene aggiunto come un normale runtime, quindi viene distribuito insieme al resto del progetto CLI AgentCore .

## ESPORTA\_ NOTES.md
<a name="_export_notes_md"></a>

Dopo ogni esportazione, `EXPORT_NOTES.md` viene scritto un elenco degli articoli che richiedono un follow-up manuale. Export scrive note su EXPORT\_ NOTES.md nella directory degli agenti elencando ogni elemento, il motivo per cui richiede attenzione e cosa fare esattamente. Leggi sempre EXPORT\_ NOTES.md prima della distribuzione.

## Opzioni di distribuzione
<a name="_deployment_options"></a>

Dopo l'esportazione, puoi distribuire il tuo agente in più ambienti di hosting:
+  **AgentCore Runtime (gestito)**: `agentcore deploy` da utilizzare per ospitare nel AgentCore Runtime, che gestisce automaticamente l'infrastruttura, la scalabilità e il provisioning delle credenziali.
+  **Self-hosted**- Distribuisci l'agente Python generato ovunque supporti Python 3.12\+:
  +  AWS servizi: Lambda, EC2 ECS/Fargate
  + cluster Kubernetes
  + On-premise server
  + Qualsiasi ambiente containerizzato