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 al. 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, il cablaggio predefinito è 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']}")

Installa la AgentCore CLI:

npm install -g @aws/agentcore

Crea un progetto di cablaggio in modo non interattivo con le bandiere:

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

Distribuisci 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 arriva al tuo terminale. Riutilizza la stessa --session-id in tutte le invocazioni per continuare la conversazione nello stesso ambiente.

Per aggiungere altri cablaggi a un progetto esistente, usa. agentcore add harness Per generare uno script di invoca Python autonomo, aggiungi. --with-invoke-script

Bandiere utili:

Installa la AgentCore CLI:

npm install -g @aws/agentcore

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

agentcore create

Dopo la conferma, la procedura guidata consolida il tuo progetto. Distribuisci con, quindi richiama conagentcore deploy. agentcore invoke

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

Se vuoi testare l'harness nel tuo ambiente locale, puoi eseguire il server di sviluppo:

agentcore dev

Quando eseguiagentcore dev, la CLI distribuisce innanzitutto le tue risorse di cablaggio AWS, creando il ruolo IAM, l'harness e qualsiasi memoria o credenziale configurata nel tuo progetto:

Una volta completata l'implementazione, avvia un server locale e apre l'Agent Inspector nel browser, dove è possibile 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: