기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AgentCore CLI 참조
<a name="agentcore-cli-reference"></a>

이 참조는 퍼블릭 Amazon Bedrock AgentCore CLI 릴리스를 문서화합니다.

**Topics**
+ [프로젝트 수명 주기](#cli-project-lifecycle)
+ [호출 및 런타임](#cli-invocation)
+ [리소스 관리](#cli-resources)
+ [평가 및 데이터 세트](#cli-evaluation)
+ [최적화 및 구성 번들](#cli-optimization)
+ [작업 및 설정](#cli-operations)

## 프로젝트 수명 주기
<a name="cli-project-lifecycle"></a>

 *`@aws/agentcore` v0.28.1에서 자동 생성 - 수동으로 편집하지 마십시오.*

### agentcore 생성
<a name="_agentcore_create"></a>

```
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 배포
<a name="_agentcore_deploy"></a>

```
agentcore deploy|dp [options]
```

CDK를 AWS 통해에 프로젝트 인프라를 배포합니다.

 **파라미터** 

 `--target <target>`*(선택 사항)*   
배포 대상 이름(기본값: "default") [비대화형]

 `-y, --yes`*(선택 사항)*   
프롬프트 자동 확인, env에서 자격 증명 읽기[비대화형]

 `-v, --verbose`*(선택 사항)*   
리소스 수준 배포 이벤트 표시[비대화형]

 `--json`*(선택 사항)*   
JSON으로 출력 [비대화형]

 `--dry-run`*(선택 사항)*   
[비대화형] 배포 없이 배포 미리 보기

 `--diff`*(선택 사항)*   
[비대화형]를 배포하지 않고 CDK diff 표시

### agentcore 개발
<a name="_agentcore_dev"></a>

```
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 패키지
<a name="_agentcore_package"></a>

```
agentcore package|pkg [options]
```

배포하지 않고 에이전트 아티팩트를 패키징합니다.

 **파라미터** 

 `-d, --directory <path>`*(선택 사항)*   
agentcore 구성이 포함된 프로젝트 디렉터리

 `-r, --runtime <name>`*(선택 사항)*   
지정된 런타임만 패키징

### agentcore 내보내기
<a name="_agentcore_export"></a>

```
agentcore export [options] [command]
```

Strands 런타임 에이전트로 하네스를 내보냅니다.

### agentcore 업데이트
<a name="_agentcore_update"></a>

```
agentcore update [options] [command]
```

CLI 업데이트 확인 및 설치

 **파라미터** 

 `-c, --check`*(선택 사항)*   
설치하지 않고 업데이트 확인

### agentcore 검증
<a name="_agentcore_validate"></a>

```
agentcore validate [options]
```

agentcore/ 구성 파일을 검증합니다.

 **파라미터** 

 `-d, --directory <path>`*(선택 사항)*   
agentcore 구성이 포함된 프로젝트 디렉터리

 `--json`*(선택 사항)*   
JSON으로 출력 [비대화형]

## 호출 및 런타임
<a name="cli-invocation"></a>

 *`@aws/agentcore` v0.28.1에서 자동 생성 - 수동으로 편집하지 마십시오.*

### agentcore 호출
<a name="_agentcore_invoke"></a>

```
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
<a name="_agentcore_exec"></a>

```
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 실행
<a name="_agentcore_run"></a>

```
agentcore run [options] [command]
```

평가, 배치 평가 또는 최적화 권장 사항을 실행합니다.

### agentcore 로그
<a name="_agentcore_logs"></a>

```
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 추적
<a name="_agentcore_traces"></a>

```
agentcore traces|t [options] [command]
```

에이전트 추적을 보고 다운로드합니다.

### agentcore 상태
<a name="_agentcore_status"></a>

```
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 가져오기
<a name="_agentcore_fetch"></a>

```
agentcore fetch [options] [command]
```

배포된 리소스에 대한 액세스 정보를 가져옵니다.

### agentcore 보기
<a name="_agentcore_view"></a>

```
agentcore view [options] [command]
```

작업 기록 및 세부 정보 보기

## 리소스 관리
<a name="cli-resources"></a>

 *`@aws/agentcore` v0.28.1에서 자동 생성됨 - 수동으로 편집하지 마십시오.*

### agentcore 추가
<a name="_agentcore_add"></a>

```
agentcore add [options] [command] [subcommand]
```

프로젝트 구성에 리소스를 추가합니다.

### agentcore 제거
<a name="_agentcore_remove"></a>

```
agentcore remove [options] [command] [subcommand]
```

프로젝트 구성에서 리소스를 제거합니다.

### agentcore 가져오기
<a name="_agentcore_import"></a>

```
agentcore import [options] [command]
```

런타임, 메모리 또는 스타터 툴킷을이 프로젝트로 가져옵니다.

 **파라미터** 

 `--source <path>`*(선택 사항)*   
.bedrock\_agentcore.yaml 구성 파일의 경로

 `--target <target>`*(선택 사항)*   
배포 대상 이름(프로젝트에 대상이 여러 개 있는 경우에만 필요)

 `-y, --yes`*(선택 사항)*   
프롬프트 자동 확인

## 평가 및 데이터 세트
<a name="cli-evaluation"></a>

 *`@aws/agentcore` v0.28.1에서 자동 생성 - 수동으로 편집하지 마세요.*

### agentcore 평가
<a name="_agentcore_evals"></a>

```
agentcore evals [options] [command]
```

과거 실행의 저장된 평가 및 배치 평가 결과를 봅니다.

### agentcore 배치 평가
<a name="_agentcore_batch_evaluations"></a>

```
agentcore batch-evaluations [options] [command] <id>
```

배치 평가 작업 및 결과를 봅니다.

 **파라미터** 

 `id`   
보려는 배치 평가 작업 ID

 `--json`*(선택 사항)*   
JSON으로 출력

### agentcore 데이터 세트
<a name="_agentcore_dataset"></a>

```
agentcore dataset [options] [command]
```

데이터 세트 콘텐츠 및 버전 관리

## 최적화 및 구성 번들
<a name="cli-optimization"></a>

 *`@aws/agentcore` v0.28.1에서 자동 생성 - 수동으로 편집하지 마십시오.*

### agentcore 구성 번들
<a name="_agentcore_config_bundle"></a>

```
agentcore config-bundle|cb [options] [command]
```

구성 번들 관리(ID가 아닌 agentcore.json의 번들 이름 사용)

### agentcore 승격
<a name="_agentcore_promote"></a>

```
agentcore promote [options] [command]
```

리소스 승격

### agentcore 아카이브
<a name="_agentcore_archive"></a>

```
agentcore archive [options] [command]
```

서비스에 대한 배치 평가 또는 권장 사항을 아카이브(삭제)하고 로컬 기록을 지웁니다.

## 작업 및 설정
<a name="cli-operations"></a>

 *`@aws/agentcore` v0.28.1에서 자동 생성 - 수동으로 편집하지 마세요.*

### agentcore 일시 중지
<a name="_agentcore_pause"></a>

```
agentcore pause [options] [command]
```

배포된 리소스를 일시 중지합니다(온라인 평가 구성, A/B 테스트).

### agentcore 재개
<a name="_agentcore_resume"></a>

```
agentcore resume [options] [command]
```

일시 중지된 리소스를 재개합니다(온라인 평가 구성, A/B 테스트).

### agentcore 중지
<a name="_agentcore_stop"></a>

```
agentcore stop [options] [command]
```

실행 중인 배치 평가 또는 A/B 테스트를 중지합니다.

### agentcore 구성
<a name="_agentcore_config"></a>

```
agentcore config [options] [key] [value]
```

원격 측정 옵트아웃 상태와 같은 글로벌 구성 설정 조정

 **파라미터** 

 `key`   
점 표기법의 Config 키(예: telemetry.enabled)

 `value`   
설정할 값

### agentcore 원격 측정
<a name="_agentcore_telemetry"></a>

```
agentcore telemetry [options] [command]
```

익명 사용 분석 기본 설정을 관리합니다.

### agentcore 피드백
<a name="_agentcore_feedback"></a>

```
agentcore feedback [options] [message]
```

AgentCore CLI에 대한 피드백을 팀에 전송합니다.

 **파라미터** 

 `message`   
피드백 메시지[비대화형]

 `--screenshot <path>`*(선택 사항)*   
PNG 또는 JPG 스크린샷 경로(최대 100MB) [비대화형]

 `--json`*(선택 사항)*   
결과를 JSON으로 출력[비대화형]