Erste Schritte

Erstellen Sie den Kabelbaum mit einem Namen und einer Ausführungsrolle:

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

Umfrage get-harness bis"status": "READY". Beachten Sie die arn in der Antwort.

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

Rufen Sie von Python aus auf. Wenn Sie kein Modell angeben, ist der Kabelbaum standardmäßig auf Anthropic Claude Sonnet 4.6 auf Amazon Bedrock eingestellt:

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']}")

Installieren Sie die AgentCore CLI:

npm install -g @aws/agentcore

Erstellen Sie ein Harness-Projekt ohne Interaktion mit Flags:

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

Bereitstellen und aufrufen:

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

Die Antwort wird zu Ihrem Terminal gestreamt. Verwenden Sie dasselbe --session-id für mehrere Aufrufe wieder, um die Konversation in derselben Umgebung fortzusetzen.

Um einem vorhandenen Projekt weitere Kabelbäume hinzuzufügen, verwenden Sie. agentcore add harness Um ein eigenständiges Python-Aufrufskript zu generieren, fügen Sie hinzu--with-invoke-script.

Nützliche Flaggen:

Installieren Sie die AgentCore CLI:

npm install -g @aws/agentcore

agentcore createOhne Flags ausführen, um den interaktiven Assistenten zu starten:

agentcore create

Nach der Bestätigung erstellt der Assistent das Gerüst für Ihr Projekt. Bereitstellen mitagentcore deploy, dann aufrufen mit. agentcore invoke

Überprüfen Sie den Projektstatus jederzeit mitagentcore status:

Wenn Sie den Harness in Ihrer lokalen Umgebung testen möchten, können Sie den Dev-Server ausführen:

agentcore dev

Bei der Ausführung agentcore dev stellt die CLI zunächst Ihre Harness-Ressourcen bereit AWS und erstellt dabei die IAM-Rolle, den Harness und alle in Ihrem Projekt konfigurierten Speicher- oder Anmeldeinformationen:

Sobald die Bereitstellung abgeschlossen ist, wird ein lokaler Server gestartet und der Agenteninspektor in Ihrem Browser geöffnet, in dem Sie mit dem Harness chatten, Traces überprüfen und Projektressourcen durchsuchen können:

Erweitern Sie die Harness-Einstellungen, um die Kabelbaumkonfiguration für die aktuelle Sitzung anzuzeigen und zu überschreiben: