기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AgentCore CLI 참조
이 참조는 퍼블릭 Amazon Bedrock AgentCore CLI 릴리스를 문서화합니다.
프로젝트 수명 주기
@aws/agentcore v0.28.1에서 자동 생성 - 수동으로 편집하지 마십시오.
agentcore 생성
agentcore create [options]
새 AgentCore 프로젝트 생성
파라미터
-
--name <name>(선택 사항) -
리소스 이름[비대화형]
-
--project-name <name>(선택 사항) -
프로젝트 이름(문자로 시작, 영숫자만, 최대 23자) [비대화형]
-
--no-agent(선택 사항) -
에이전트 생성 건너뛰기[비대화형]
-
--defaults(선택 사항) -
기본 설정(기본값)으로 하네스 프로젝트 생성 [비대화형]
-
--build <type>(선택 사항) -
빌드 유형: CodeZip 또는 컨테이너(기본값: CodeZip) [비대화형]
-
--language <language>(선택 사항) -
대상 언어: Python 또는 TypeScript(기본값: Python) [비대화형]
-
--framework <framework>(선택 사항) -
에이전트 프레임워크(스트랜드, LangChain_LangGraph, GoogleADK, OpenAIAgents, VercelAI) [비대화형]
-
--model-provider <provider>(선택 사항) -
모델 공급자(Bedrock, Anthropic, OpenAI, Gemini) [비대화형]
-
--api-key <key>(선택 사항) -
비 Bedrock 공급자를 위한 API 키[비대화형]
-
--memory <option>(선택 사항) -
메모리 옵션(없음, shortTerm, longAndShortTerm) [비대화형]
-
--protocol <protocol>(선택 사항) -
프로토콜: HTTP, MCP, A2A, AGUI(기본값: HTTP) [비대화형]
-
--type <type>(선택 사항) -
에이전트 유형: 생성 또는 가져오기(기본값: 생성) [비대화형]
-
--agent-id <id>(선택 사항) -
Bedrock 에이전트 ID(--type 가져오기에 필요) [비대화형]
-
--agent-alias-id <id>(선택 사항) -
Bedrock 에이전트 별칭 ID(--type 가져오기에 필요) [비대화형]
-
--region <region>(선택 사항) -
Bedrock Agent의 AWS 리전(--type 가져오기에 필요) [비대화형]
-
--network-mode <mode>(선택 사항) -
네트워크 모드(PUBLIC, VPC) [비대화형]
-
--subnets <ids>(선택 사항) -
쉼표로 구분된 서브넷 IDs(VPC 모드에 필요) [비대화형]
-
--security-groups <ids>(선택 사항) -
쉼표로 구분된 보안 그룹 IDs(VPC 모드에 필요) [비대화형]
-
--vpc-id <id>(선택 사항) -
VPC ID(VPC 모드의 컨테이너 빌드에 필요) [비대화형]
-
--idle-timeout <seconds>(선택 사항) -
유휴 세션 제한 시간(초) [비대화형]
-
--max-lifetime <seconds>(선택 사항) -
초 단위의 최대 인스턴스 수명(60~28800)[비대화형]
-
--session-storage-mount-path <path>(선택 사항) -
/mnt 미만의 세션 파일 시스템 스토리지에 대한 절대 탑재 경로(예: /mnt/data) [비대화형]
-
--efs-access-point-arn <arn>(선택 사항) -
EFS 액세스 포인트 ARN(반복 가능, --efs-mount-path와 페어링됨) [비대화형](기본값: [])
-
--efs-mount-path <path>(선택 사항) -
EFS 탑재 경로(예: /mnt/tools, --efs-access-point-arn과 페어링됨) [비대화형](기본값: [])
-
--s3-access-point-arn <arn>(선택 사항) -
S3 파일 액세스 포인트 ARN(반복 가능, --s3-mount-path와 페어링됨) [비대화형](기본값: [])
-
--s3-mount-path <path>(선택 사항) -
S3 파일 탑재 경로(예: /mnt/datasets, --s3-access-point-arn과 페어링됨) [비대화형](기본값: [])
-
--with-config-bundle(선택 사항) -
에이전트 템플릿에 연결된 구성 번들 생성[비대화형]
-
--output-dir <dir>(선택 사항) -
출력 디렉터리(기본값: 현재 디렉터리) [비대화형]
-
--skip-git(선택 사항) -
git 리포지토리 초기화 건너뛰기[비대화형]
-
--skip-python-setup(선택 사항) -
Python 가상 환경 설정 건너뛰기[비대화형]
-
--skip-install(선택 사항) -
모든 종속성 설치 건너뛰기(npm 설치, uv 동기화) [비대화형]
-
--dry-run(선택 사항) -
변경하지 않고 생성할 내용 미리 보기[비대화형]
-
--json(선택 사항) -
JSON으로 출력 [비대화형]
-
--model-id <id>(선택 사항) -
하네스의 모델 ID[비대화형]
-
--api-key-arn <arn>(선택 사항) -
비 Bedrock 하네스 공급자를 위한 API 키 ARN[비대화형]
-
--api-base <url>(선택 사항) -
하네스 모델 공급자 API 엔드포인트(lite_llm)의 기본 URL[비대화형]
-
--additional-params <json>(선택 사항) -
JSON 객체(lite_llm)로서의 공급자별 하네스 파라미터[비대화형]
-
--no-harness-memory(선택 사항) -
하네스의 메모리 비활성화(기본값) [비대화형]
-
--max-iterations <n>(선택 사항) -
최대 에이전트 루프 반복(하니스) [비대화형]
-
--max-tokens <n>(선택 사항) -
반복당 최대 토큰 수(하니스) [비대화형]
-
--timeout <seconds>(선택 사항) -
초 단위의 최대 실행 기간(하니스) [비대화형]
-
--truncation-strategy <strategy>(선택 사항) -
자르기 전략: sliding_window 또는 요약(하니스)[비대화형]
-
--container <uri-or-path>(선택 사항) -
컨테이너 이미지 URI 또는 Dockerfile 경로(하니스)[비대화형]
agentcore 배포
agentcore deploy|dp [options]
CDK를 AWS 통해에 프로젝트 인프라를 배포합니다.
파라미터
-
--target <target>(선택 사항) -
배포 대상 이름(기본값: "default") [비대화형]
-
-y, --yes(선택 사항) -
프롬프트 자동 확인, env에서 자격 증명 읽기[비대화형]
-
-v, --verbose(선택 사항) -
리소스 수준 배포 이벤트 표시[비대화형]
-
--json(선택 사항) -
JSON으로 출력 [비대화형]
-
--dry-run(선택 사항) -
[비대화형] 배포 없이 배포 미리 보기
-
--diff(선택 사항) -
[비대화형]를 배포하지 않고 CDK diff 표시
agentcore 개발
agentcore dev|d [options] [prompt]
로컬 개발 서버를 시작하거나 로컬에서 에이전트를 호출합니다.
파라미터
-
prompt -
실행 중인 개발 서버에 프롬프트 전송 [비대화형]
-
-p, --port <port>(선택 사항) -
개발 서버용 포트입니다. 명시적으로 설정할 때 있는 그대로 사용됩니다. 기본값은 다중 런타임 프로젝트의 런타임 인덱스에 의해 오프셋됩니다(기본값: "8080").
-
-r, --runtime <name>(선택 사항) -
실행 또는 호출할 런타임(여러 런타임의 경우 필수)
-
-s, --stream(선택 사항) -
[비대화형] 호출 시 스트림 응답
-
-l, --logs(선택 사항) -
로그를 사용하여 개발 서버를 실행하여 stdout [비대화형]
-
--exec(선택 사항) -
실행 중인 개발 컨테이너에서 셸 명령 실행(컨테이너 에이전트만 해당) [비대화형]
-
--tool <name>(선택 사항) -
MCP 도구 이름("call-tool" 프롬프트와 함께 사용) [비대화형]
-
--input <json>(선택 사항) -
JSON으로 MCP 도구 인수(--tool과 함께 사용) [비대화형]
-
--skip-deploy(선택 사항) -
개발 서버를 시작하기 전에 자동 리소스 배포 건너뛰기
-
-H, --header <header>(선택 사항) -
에이전트에 전달할 사용자 지정 헤더(형식: "Name: Value", 반복 가능) [비대화형](기본값: [])
-
-b, --no-browser(선택 사항) -
웹 기반 채팅 UI 대신 터미널 TUI 사용
-
--no-traces(선택 사항) -
로컬 OTEL 추적 수집 비활성화
agentcore 패키지
agentcore package|pkg [options]
배포하지 않고 에이전트 아티팩트를 패키징합니다.
파라미터
-
-d, --directory <path>(선택 사항) -
agentcore 구성이 포함된 프로젝트 디렉터리
-
-r, --runtime <name>(선택 사항) -
지정된 런타임만 패키징
agentcore 내보내기
agentcore export [options] [command]
Strands 런타임 에이전트로 하네스를 내보냅니다.
agentcore 업데이트
agentcore update [options] [command]
CLI 업데이트 확인 및 설치
파라미터
-
-c, --check(선택 사항) -
설치하지 않고 업데이트 확인
agentcore 검증
agentcore validate [options]
agentcore/ 구성 파일을 검증합니다.
파라미터
-
-d, --directory <path>(선택 사항) -
agentcore 구성이 포함된 프로젝트 디렉터리
-
--json(선택 사항) -
JSON으로 출력 [비대화형]
호출 및 런타임
@aws/agentcore v0.28.1에서 자동 생성 - 수동으로 편집하지 마십시오.
agentcore 호출
agentcore invoke|i [options] [prompt]
배포된 에이전트 엔드포인트를 호출합니다.
파라미터
-
prompt -
에이전트에게 전송하라는 프롬프트입니다. 프롬프트가 제공되지 않고 stdin이 TTY[비대화형]가 아닌 경우에도 파이프된 stdin을 수락합니다.
-
--prompt <text>(선택 사항) -
에이전트에 전송하라는 프롬프트 [비대화형]
-
--prompt-file <path>(선택 사항) -
파일에서 프롬프트 읽기(셸 arg 제한을 초과하는 길거나 구조화된 페이로드의 경우) [비대화형]
-
--runtime <name>(선택 사항) -
특정 런타임 선택[비대화형]
-
--gateway <name>(선택 사항) -
게이트웨이를 통해 호출 [비대화형]
-
--gateway-target-name <name>(선택 사항) -
게이트웨이의 HTTP 런타임 대상[비대화형]
-
--target <name>(선택 사항) -
배포 대상 선택 [비대화형]
-
--session-id <id>(선택 사항) -
대화 연속성을 위해 특정 세션 ID 사용
-
--user-id <id>(선택 사항) -
런타임 호출을 위한 사용자 ID(기본값: "default-user")
-
--api-base <url>(선택 사항) -
하네스 호출에 대한 LiteLLM API 기본 URL 재정의입니다. 비대화형 모드에서는 에서만 사용할
lite_llm수 있습니다. -
--additional-params <json>(선택 사항) -
하네스 호출을 위한 JSON 객체인 추가 LiteLLM 파라미터입니다. 비대화형 모드에서는 에서만 사용할
lite_llm수 있습니다. -
--payment-user-id <id>(선택 사항) -
최종 사용자/월릿 소유자 자격 증명(기본값은 --user-id)
-
--payment-instrument-id <id>(선택 사항) -
결제 계측(월릿) ID
-
--payment-session-id <id>(선택 사항) -
예산 추적을 위한 결제 세션 ID
-
--auto-session(선택 사항) -
테스트를 위한 결제 세션 자동 생성/재사용
-
--json(선택 사항) -
JSON으로 출력
-
--stream(선택 사항) -
실시간 스트림 응답
-
--tool <name>(선택 사항) -
MCP 도구 이름("call-tool" 프롬프트와 함께 사용)
-
--input <json>(선택 사항) -
JSON으로 MCP 도구 인수(--tool과 함께 사용)
-
--exec(선택 사항) -
런타임 컨테이너에서 셸 명령 실행
-
--timeout <seconds>(선택 사항) -
--exec 명령의 초 단위 제한 시간
-
-H, --header <header>(선택 사항) -
사용자 지정 헤더 "이름: 값"(반복 가능)
-
--bearer-token <token>(선택 사항) -
CUSTOM_JWT 인증을 위한 베어러 토큰(SigV4 우회)
-
--harness <name>(선택 사항) -
호출할 특정 하네스 선택
-
--harness-arn <arn>(선택 사항) -
ARN으로 하네스 호출(프로젝트 필요 없음)
-
--region <region>(선택 사항) -
AWS 리전(--harness-arn에 필요)
-
--verbose(선택 사항) -
자세한 스트리밍 JSON 이벤트 인쇄
-
--model-id <id>(선택 사항) -
모델 재정의
-
--model-provider <provider>(선택 사항) -
모델 공급자입니다. 유효한 값:
bedrock,open_ai또는gemini. -
--api-key-arn <arn>(선택 사항) -
open_ai/gemini용 API 키 ARN
-
--tools <tools>(선택 사항) -
도구 재정의(쉼표로 구분)
-
--allowed-tools <tools>(선택 사항) -
허용된 도구 재정의(쉼표로 구분)
-
--skills <paths>(선택 사항) -
기술(쉼표로 구분된 경로)
-
--system-prompt <text>(선택 사항) -
시스템 프롬프트 재정의
-
--actor-id <id>(선택 사항) -
메모리 액터 ID 재정의
-
--max-iterations <n>(선택 사항) -
최대 반복 재정의
-
--max-tokens <n>(선택 사항) -
최대 토큰 재정의
-
--harness-timeout <seconds>(선택 사항) -
제한 시간 초 재정의
agentcore exec
agentcore exec [options] [command...]
대화형 셸을 열거나 배포된 에이전트 컨테이너에서 원샷 명령을 실행합니다.
파라미터
-
command -
실행할 명령(원샷 모드, 비대화형)
-
--it(선택 사항) -
대화형 PTY 쉘 세션 열기
-
--runtime <name|arn>(선택 사항) -
대상 에이전트 이름 또는 런타임 ARN(에이전트 선택기 건너뛰기)
-
--harness <name|arn>(선택 사항) -
대상 하네스 이름 또는 하네스 ARN(에이전트 선택기 건너뛰기)
-
--session-id <id>(선택 사항) -
특정 런타임 세션/VM에 고정
-
--shell-id <id>(선택 사항) -
기존 쉘에 다시 연결
-
--region <region>(선택 사항) -
AWS 리전
-
--bearer-token <token>(선택 사항) -
CUSTOM_JWT 인증을 위한 베어러 토큰(SigV4 건너뛰기)
-
--target <name>(선택 사항) -
배포 대상 이름( agentcore.json에서)
-
--timeout <seconds>(선택 사항) -
원샷 명령의 초 단위 제한 시간
-
--json(선택 사항) -
결과를 JSON으로 출력(원샷 모드만 해당, --it와 호환되지 않음)
agentcore 실행
agentcore run [options] [command]
평가, 배치 평가 또는 최적화 권장 사항을 실행합니다.
agentcore 로그
agentcore logs|l [options] [command]
에이전트 런타임 로그를 스트리밍하거나 검색합니다.
파라미터
-
--runtime <name>(선택 사항) -
특정 런타임 선택
-
--since <time>(선택 사항) -
시작 시간 - 검색 모드에서 기본값은 1시간 전입니다(예: "1h", "30m", "2d", ISO 8601).
-
--until <time>(선택 사항) -
종료 시간 - 기본값은 이제 검색 모드(예: "now", ISO 8601)입니다.
-
--level <level>(선택 사항) -
로그 수준(오류, 경고, 정보, 디버그)을 기준으로 필터링
-
-n, --limit <count>(선택 사항) -
반환할 최대 로그 줄 수
-
--query <text>(선택 사항) -
서버 측 텍스트 필터
-
--json(선택 사항) -
JSON 라인으로 출력
agentcore 추적
agentcore traces|t [options] [command]
에이전트 추적을 보고 다운로드합니다.
agentcore 상태
agentcore status|s [options]
배포된 리소스 세부 정보 및 상태를 표시합니다.
파라미터
-
--runtime-id <id>(선택 사항) -
ID로 특정 런타임 조회
-
--target <name>(선택 사항) -
배포 대상 선택
-
--type <type>(선택 사항) -
리소스 유형(에이전트, 런타임 엔드포인트, 메모리, 자격 증명, 게이트웨이, 평가자, 온라인 평가, 결제, 정책 엔진, 정책, config-bundle, 데이터 세트, 지식 기반, 하네스)을 기준으로 필터링
-
--state <state>(선택 사항) -
배포 상태(배포됨, 로컬 전용, 제거 보류 중)를 기준으로 필터링
-
--runtime <name>(선택 사항) -
특정 런타임으로 필터링
-
--name <name>(선택 사항) -
이름별 단일 리소스에 대한 세부 정보 표시(knowledge-base)
-
--json(선택 사항) -
JSON으로 출력
agentcore 가져오기
agentcore fetch [options] [command]
배포된 리소스에 대한 액세스 정보를 가져옵니다.
agentcore 보기
agentcore view [options] [command]
작업 기록 및 세부 정보 보기
리소스 관리
@aws/agentcore v0.28.1에서 자동 생성됨 - 수동으로 편집하지 마십시오.
agentcore 추가
agentcore add [options] [command] [subcommand]
프로젝트 구성에 리소스를 추가합니다.
agentcore 제거
agentcore remove [options] [command] [subcommand]
프로젝트 구성에서 리소스를 제거합니다.
agentcore 가져오기
agentcore import [options] [command]
런타임, 메모리 또는 스타터 툴킷을이 프로젝트로 가져옵니다.
파라미터
-
--source <path>(선택 사항) -
.bedrock_agentcore.yaml 구성 파일의 경로
-
--target <target>(선택 사항) -
배포 대상 이름(프로젝트에 대상이 여러 개 있는 경우에만 필요)
-
-y, --yes(선택 사항) -
프롬프트 자동 확인
평가 및 데이터 세트
@aws/agentcore v0.28.1에서 자동 생성 - 수동으로 편집하지 마세요.
agentcore 평가
agentcore evals [options] [command]
과거 실행의 저장된 평가 및 배치 평가 결과를 봅니다.
agentcore 배치 평가
agentcore batch-evaluations [options] [command] <id>
배치 평가 작업 및 결과를 봅니다.
파라미터
-
id -
보려는 배치 평가 작업 ID
-
--json(선택 사항) -
JSON으로 출력
agentcore 데이터 세트
agentcore dataset [options] [command]
데이터 세트 콘텐츠 및 버전 관리
최적화 및 구성 번들
@aws/agentcore v0.28.1에서 자동 생성 - 수동으로 편집하지 마십시오.
agentcore 구성 번들
agentcore config-bundle|cb [options] [command]
구성 번들 관리(ID가 아닌 agentcore.json의 번들 이름 사용)
agentcore 승격
agentcore promote [options] [command]
리소스 승격
agentcore 아카이브
agentcore archive [options] [command]
서비스에 대한 배치 평가 또는 권장 사항을 아카이브(삭제)하고 로컬 기록을 지웁니다.
작업 및 설정
@aws/agentcore v0.28.1에서 자동 생성 - 수동으로 편집하지 마세요.
agentcore 일시 중지
agentcore pause [options] [command]
배포된 리소스를 일시 중지합니다(온라인 평가 구성, A/B 테스트).
agentcore 재개
agentcore resume [options] [command]
일시 중지된 리소스를 재개합니다(온라인 평가 구성, A/B 테스트).
agentcore 중지
agentcore stop [options] [command]
실행 중인 배치 평가 또는 A/B 테스트를 중지합니다.
agentcore 구성
agentcore config [options] [key] [value]
원격 측정 옵트아웃 상태와 같은 글로벌 구성 설정 조정
파라미터
-
key -
점 표기법의 Config 키(예: telemetry.enabled)
-
value -
설정할 값
agentcore 원격 측정
agentcore telemetry [options] [command]
익명 사용 분석 기본 설정을 관리합니다.
agentcore 피드백
agentcore feedback [options] [message]
AgentCore CLI에 대한 피드백을 팀에 전송합니다.
파라미터
-
message -
피드백 메시지[비대화형]
-
--screenshot <path>(선택 사항) -
PNG 또는 JPG 스크린샷 경로(최대 100MB) [비대화형]
-
--json(선택 사항) -
결과를 JSON으로 출력[비대화형]
