Conceitos básicos

Crie o arnês com um nome e uma função de execução:

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

Enquete get-harness até"status": "READY". Observe o arn na resposta.

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

Invoque a partir do Python. Se você não especificar um modelo, o equipamento usa como padrão o Anthropic Claude Sonnet 4.6 no 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']}")

Instale a AgentCore CLI:

npm install -g @aws/agentcore

Crie um projeto de arnês de forma não interativa com sinalizadores:

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

Implemente e invoque:

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

A resposta é transmitida para o seu terminal. Reutilize o mesmo --session-id em todas as invocações para continuar a conversa no mesmo ambiente.

Para adicionar mais chicotes a um projeto existente, useagentcore add harness. Para gerar um script de invocação autônomo do Python, adicione. --with-invoke-script

Sinalizadores úteis:

Instale a AgentCore CLI:

npm install -g @aws/agentcore

Execute agentcore create sem sinalizadores para iniciar o assistente interativo:

agentcore create

Após a confirmação, o assistente monta seu projeto. Implante com agentcore deploy e, em seguida, invoque comagentcore invoke.

Verifique o status do projeto a qualquer momento comagentcore status:

Se quiser testar o equipamento em seu ambiente local, você pode executar o servidor de desenvolvimento:

agentcore dev

Quando você executaagentcore dev, a CLI primeiro implanta seus recursos de harness AWS, criando a função do IAM, o harness e qualquer memória ou credencial configuradas em seu projeto:

Após a conclusão da implantação, ele inicia um servidor local e abre o inspetor de agentes em seu navegador, onde você pode conversar com o equipamento, inspecionar rastreamentos e procurar recursos do projeto:

Expanda as configurações do arnês para visualizar e substituir a configuração do arnês da sessão atual: