시작하기

이름 및 실행 역할로 하네스를 생성합니다.

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

get-harness 까지 폴링합니다"status": "READY". 응답의 arn에 주의하세요.

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

Python에서를 호출합니다. 모델을 지정하지 않으면 Amazon Bedrock에서 하네스의 기본값은 Anthropic Claude Sonnet 4.6입니다.

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 CLI를 설치합니다.

npm install -g @aws/agentcore

플래그와 상호 작용하지 않는 하네스 프로젝트를 생성합니다.

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

배포 및 호출:

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

응답이 터미널로 스트리밍됩니다. 호출 --session-id 간에 동일한를 재사용하여 동일한 환경에서 대화를 계속합니다.

기존 프로젝트에 더 많은 하네스를 추가하려면를 사용합니다agentcore add harness. 독립 실행형 Python 호출 스크립트를 생성하려면를 추가합니다--with-invoke-script.

유용한 플래그:

AgentCore CLI를 설치합니다.

npm install -g @aws/agentcore

플래그 agentcore create 없이를 실행하여 대화형 마법사를 시작합니다.

agentcore create

확인 후 마법사가 프로젝트를 스캐폴드합니다. 를 사용하여 배포agentcore deploy한 다음를 사용하여 호출합니다agentcore invoke.

를 사용하여 언제든지 프로젝트 상태를 확인합니다agentcore status.

로컬 환경에서 하네스를 테스트하려면 개발 서버를 실행할 수 있습니다.

agentcore dev

agentcore dev를 실행하면 CLI는 먼저에 하네스 리소스를 배포하여 IAM 역할, 하네스 및 프로젝트에 구성된 메모리 또는 자격 증명을 AWS생성합니다.

배포가 완료되면 로컬 서버를 시작하고 브라우저에서 에이전트 검사기를 열어 하네스와 채팅하고, 트레이스를 검사하고, 프로젝트 리소스를 찾아볼 수 있습니다.

현재 세션의 하네스 구성을 보고 재정의하려면 하네스 설정을 확장합니다.