Nozioni di base

Crea l'harness con un nome e un ruolo di esecuzione:

aws bedrock-agentcore-control create-harness \
  --harness-name "MyHarness" \
  --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole"

Sondaggio fino a. get-harness "status": "READY" Prendere nota dell'ID arn nella risposta.

aws bedrock-agentcore-control get-harness \
  --harness-id "MyHarness-XyZ123"

Invoca da Python. Se non specifichi un modello, l'impostazione predefinita è Anthropic Claude Sonnet 4.6 su Amazon Bedrock:

import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

response = client.invoke_harness(
    harnessArn="arn:aws:bedrock-agentcore:us-west-2:123456789012:harness/MyHarness-XyZ123",  # Replace with your harness ARN
    runtimeSessionId="1234abcd-12ab-34cd-56ef-1234567890ab",
    messages=[{
        "role": "user",
        "content": [{"text": "Research three tropical vacation options under $3k."}]
    }],
)

for event in response["stream"]:
    if "contentBlockDelta" in event:
        delta = event["contentBlockDelta"].get("delta", {})
        if "text" in delta:
            print(delta["text"], end="", flush=True)
    elif "runtimeClientError" in event:
        print(f"\nError: {event['runtimeClientError']['message']}")

AgentCore Installa la CLI:

npm install -g @aws/agentcore

Crea un progetto Harness in modo non interattivo con i flag:

agentcore create --name myresearchagent --model-provider bedrock

Implementa e richiama:

agentcore deploy
agentcore invoke --harness myresearchagent \
  --session-id "$(uuidgen)" \
  "Research three tropical vacation options under $3k, within five hours of NYC."

La risposta viene trasmessa al tuo terminale. Riutilizza la stessa --session-id tra le chiamate per continuare la conversazione nello stesso ambiente.

Per aggiungere ulteriori vantaggi a un progetto esistente, usa. agentcore add harness Per generare uno script di invocazione Python autonomo, aggiungi. --with-invoke-script

Bandiere utili:

Installa la AgentCore CLI:

npm install -g @aws/agentcore

Esegui agentcore create senza flag per avviare la procedura guidata interattiva:

agentcore create

Dopo la conferma, il wizard rafforza il tuo progetto. Implementa conagentcore deploy, quindi richiama con. agentcore invoke

Controlla lo stato del progetto in qualsiasi momento con: agentcore status

Se vuoi testare il cablaggio nel tuo ambiente locale, puoi eseguire il server di sviluppo:

agentcore dev

Durante l'esecuzioneagentcore dev, la CLI distribuisce innanzitutto le risorse del cablaggio AWS, creando il ruolo IAM, il cablaggio e qualsiasi memoria o credenziale configurate nel progetto:

Una volta completata la distribuzione, avvia un server locale e apre l'agent inspector nel browser, dove puoi chattare con l'harness, ispezionare le tracce e sfogliare le risorse del progetto:

Espandi le impostazioni del cablaggio per visualizzare e sovrascrivere la configurazione del cablaggio per la sessione corrente: