조직, 프로젝트 및 작업 공간 관리

모든 조직 나열

계정이 속한 모든 조직을 나열하려면 다음 명령을 실행 .

agentengine organization list

조직 세부 정보 가져오기

특정 조직 에 대한 세부 정보를 조회 하려면 다음 명령어를 실행 . <org-id>을(를) 조직 ID 로 바꿉니다.

agentengine organization get <org-id>

모든 프로젝트 나열

조직 의 모든 프로젝트를 나열하려면 다음 명령어를 실행 .

agentengine project list [--org-id <org-id>]

--org-id 플래그를 사용하여 조직 ID 지정할 수 있습니다. 기본값 으로 CLI 로컬에 저장된 인증 상태 에서 이 값을 읽습니다.

프로젝트 세부 정보 가져오기

특정 프로젝트 의 세부 정보를 조회 하려면 다음 명령어를 실행 . <project-id>을 프로젝트 ID 로 바꿉니다.

agentengine project get <project-id>

모든 작업 공간 나열

프로젝트 의 모든 작업 공간을 나열하려면 다음 명령을 실행 .

agentengine workspace list [--project-id <id>] [--org-id <id>] [--base-url <url>] [--json]

다음 표에서는 사용 가능한 플래그에 대해 설명합니다.

작업 공간 세부 정보 가져오기

특정 작업 공간에 대한 세부 정보를 조회 하려면 agentengine workspace get 명령을 실행 .

agentengine workspace get <workspace-id> [--project-id <id>] [--org-id <id>] [--base-url <url>] [--json]

다음 표에서는 사용 가능한 플래그에 대해 설명합니다.

작업 공간 만들기

agentengine workspace create 명령은 플랫폼에 새 작업 공간을 생성합니다. name 및 entrypoint 필드가 포함된 agent.yaml 파일 이 포함된 에이전트 디렉토리 에서 이 명령을 실행합니다.

이 명령은 agent.yaml에서 description, framework, features, agent_card를 자동으로 읽고, 로컬 git 리포지토리(있는 경우)에서 GitOps 필드를 자동으로 감지합니다. --description 및 --framework 플래그를 사용하여 agent.yaml의 값을 재정의합니다.

프로젝트 에 대한 작업 공간이 이미 존재하는 경우 명령은 기존 작업 공간 ID 출력하고 성공적으로 종료됩니다.

agentengine workspace create [--description <desc>] [--framework <fw>] [--project-id <id>] [--org-id <id>] [--base-url <url>] [--json]

다음 표에서는 사용 가능한 플래그에 대해 설명합니다.

작업 공간 업데이트

agentengine workspace update 명령은 기존 작업 공간을 부분적으로 업데이트합니다. 명시적으로 제공된 플래그만 업데이트 요청 에 포함됩니다.

agentengine workspace update <workspace-id> [flags]

다음 표에서는 사용 가능한 플래그에 대해 설명합니다.

API 사용하여 작업 공간 관리

작업 공간 명령은 Atlas Agent Engine API 호출합니다. 프로그래밍 방식으로 작업 공간을 관리 하려면 이러한 엔드포인트를 직접 호출합니다.

각 작업 공간 엔드포인트의 범위는 단일 프로젝트 입니다. 둘 이상의 프로젝트 에서 엔드포인트를 호출하는 경우 요청 에 프로젝트 ID 포함하세요.

다음 표에서는 사용 가능한 엔드포인트에 대해 설명합니다. {project-id}를 프로젝트 ID 로 바꾸고 {workspace-id}을 작업 공간 ID 로 바꿉니다.

서비스 계정 만들기

새 서비스 계정을 만들려면 다음 명령을 실행 .

agentengine service-account create <name> --role <role> [--org-id <id> | --project-id <id>] [--description <text>] [--secret-expires-in <duration>] [--ip-access-list <ip-or-cidr>,...] [--json]

이 명령은 다음 예시 와 같이 일반 텍스트 클라이언트 암호와 서비스 계정의 세부 정보를 출력합니다.

Client Secret: agp_sa_sk_...
Client ID:     agp_sa_id_...
Name:          ci-pipeline
...

다음 표에서는 사용 가능한 플래그에 대해 설명합니다.

서비스 계정 나열

현재 프로젝트 또는 조직 의 모든 서비스 계정을 나열하려면 다음 명령어를 실행 .

agentengine service-account list [--org-id <id>] [--project-id <id>] [--limit <n>]

이 명령은 각 서비스 계정에 대한 클라이언트 ID, 이름, 역할, 활성 상태, 시크릿 만료, 시크릿 마지막 사용 날짜, 설명이 포함된 테이블을 표시합니다.

기본값 으로 이 명령은 로컬에 저장된 인증 상태 의 프로젝트 에 대한 서비스 계정을 나열합니다. 다른 조직 또는 프로젝트 의 서비스 계정을 나열하려면 --org-id 또는 --project-id 플래그를 사용합니다.

서비스 계정 비밀 로테이션

서비스 계정에 대한 새 클라이언트 비밀을 발급하려면 다음 명령을 실행 .

agentengine service-account rotate <client-id> [--org-id <id>] [--project-id <id>] [--secret-expires-in <duration>]

이 명령은 새 일반 텍스트 클라이언트 암호를 출력합니다. 이전 암호는 최대 7일 또는 만료일 중 먼저 도래하는 날짜까지 유효합니다.

서비스 계정 삭제

서비스 계정을 영구적으로 삭제 하려면 다음 명령어를 실행 .

agentengine service-account delete <client-id> [--org-id <id>] [--project-id <id>]

서비스 계정을 삭제 후에는 더 이상 액세스 토큰을 요청 수 없으며 이미 보유하고 있는 토큰은 다음에 사용할 때 실패합니다.

CLI 버전 확인

agentengine version 명령은 CLI 출시하다 버전, 바이너리가 빌드된 git 커밋 , 로컬 개발 스택 에서 사용하는 기본값 컨테이너 이미지 태그를 출력합니다.

CLI 버전을 조회 하려면 다음 명령을 실행 .

agentengine version [--json]

출력은 다음과 유사합니다.

0.1.94-alpha (commit: <hash>)
image registry: ECR
runner-base: <registry>/runner-base:0.1.94-alpha
runner-base-typescript-langgraph: <registry>/runner-base-typescript-langgraph:0.1.94-alpha
playground-ui: <registry>/playground-ui:0.1.94-alpha
orchestrator: <registry>/orchestration-engine:<version>
memory-server: <registry>/memory-server:<version>

CLI 업데이트

agentengine self-update 명령은 현재 OS 및 아키텍처에 대해 일치하는 최신 출시하다 자산 다운로드하고, 해당 자산 의 SHA-256 체크섬 확인하며, 현재 설치 경로에 있는 기존 바이너리를 대체합니다.

Atlas Agent Engine에 로그인하면 CLI 가 플랫폼 API 게이트웨이에서 사용 가능한 릴리스 목록을 검색합니다.

CLI 업데이트 하려면 다음 명령을 실행 .

agentengine self-update [--force] [--auto[=true|false]]

다음 표에서는 사용 가능한 플래그에 대해 설명합니다.

대부분의 agentengine 명령을 실행 때 최신 출시하다 있는 경우 CLI stderr에 한 줄 알림을 출력합니다. CLI 24시간마다 한 번씩 업데이트 확인을 실행합니다. 검사를 완전히 비활성화하려면 셸 에서 AGENTENGINE_NO_UPDATE_CHECK=1 환경 변수를 설정하다 .