에이전트와 운영 명령
에이전트
에이전트를 만들고, 가져오고, 고치고, 배포해요. 대시보드에서 만든 에이전트도pull로 가져와 파일로 관리할 수 있어요.
플로우 편집
플로우 에이전트의 노드와 연결을 명령으로 고쳐요. 아래support_router는 앞에서 만든 Flow 에이전트예요. graph로 전체 노드와 연결을 확인할 수 있어요.
도구
에이전트가 통화 중에 부르는 커스텀 도구를 파일로 관리해요. API 키 같은 비밀 값은 파일에 남지 않도록 참조 형태로만 적어요.지식 베이스
지식 베이스를 문서 단위로 정의하고 배포해요. 텍스트, 웹페이지, 저장소 안의 파일을 문서로 추가할 수 있어요.통화
터미널에서 바로 아웃바운드 통화를 걸고 결과를 확인해요. JSON 배열을 넘기면 여러 건을 차례로 발신해요.대량 발신
대량 발신(campaign)을 만들고 진행을 제어해요. 대상은 --to를 반복하거나 call_to 객체 배열 파일을 --tasks로 넘기세요.
전화번호
보유 번호에 에이전트를 연결하고, 통신서비스 이용증명원을 발급하고, 발신표기번호를 등록해요.위젯
웹사이트 위젯을 만들고 게시해요.list, get, create, update, delete, publish, unpublish 명령 7개가 있고, get --snippet은 설치 코드를 출력해요.
보이스와 모델
쓸 수 있는 LLM과 보이스를 조회하고, 보이스를 복제해요.채팅 테스트
전화를 걸지 않고 터미널에서 에이전트와 대화해 봐요.--input을 반복하면 여러 턴 대화 시나리오를 한 번에 검증하고, --voice는 마이크로 실제 음성 대화를 해요.
워크스페이스 동기화
원격 워크스페이스 전체를 저장소로 가져오거나, 로컬과 원격이 얼마나 어긋났는지 확인해요. 워크스페이스가 여럿이면 저장소 하나에서 오가며 관리할 수 있어요.워크스페이스 관리
워크스페이스 정보와 통화 사용량·한도, 멤버, 청구서, 인증 상태를 조회하고 하위 워크스페이스를 만들거나 삭제해요. 하위 워크스페이스는--sub-org로 지정하세요.
메뉴얼
메뉴얼은 에이전트별agents/<agent>/manuals/<local-name>/manual.json 파일로 관리해요. agent push와 별도로 manual push를 실행해야 원격 에이전트에 메뉴얼이 저장돼요.
manual diff는 원격에서 가져오거나 한 번 저장한 메뉴얼에 쓸 수 있어요. manual push는 해당 에이전트의 메뉴얼 전체를 반영해요. 원격에서 메뉴얼이 바뀌어 REMOTE_CHANGED가 나오면 manual pull로 변경을 가져와 검토하세요. manual pull --force는 에이전트 전체 메뉴얼의 로컬 수정을 버릴 수 있어요.
저장과 프로덕션 지정
<version>에는 version save 결과의 v1, v2 같은 값을 넣으세요. 운영 중인 에이전트를 바꾸기 전에 대상과 변경 내용을 확인하세요.
코딩 에이전트 지침
agent plan은 설계안을, agent create --task는 요청에 맞는 초안을 만들어요. skills refresh는 CLI가 관리하는 .claude/skills/vox-ai/SKILL.md와 .codex/skills/vox-ai/SKILL.md를 갱신해요. 이 파일을 직접 수정하면 갱신할 때 덮어쓸 수 있어요. 처음부터 만들지 않으려면 vox init --no-agent-skills를 쓰세요.
JSON으로 결과 받기
모든 명령이--json을 지원해요. 스크립트나 CI에서 결과를 파싱해 쓰세요.
인증과 프로필 관리하기
로그인은 OAuth만 지원하고, 토큰은 OS 키체인에 저장돼요. API 키를 파일에 남기지 않아요.
토큰은 CI의 비밀 변수에 보관하세요. 환경 변수로 준 토큰이 만료되면 새 토큰으로 교체해야 해요.
사용 정보 수집
공식 배포 빌드는 CLI 사용 정보와 로그인 계정 정보를 늘 수집해요. PostHog로 보내는 항목은 사용자 ID, 이메일, 이름, 프로필, install ID, 마지막 로그인 시각, 현재·기본 워크스페이스 정보, 명령 실행 정보예요. 프롬프트, 파일 경로와 내용, 명령 인자 값, 토큰, 시크릿, 메시지 내용, 고객 데이터는 수집하지 않아요. 공식 배포 빌드는 텔레메트리 수집을 끌 수 없어요.오류와 예외
- 인증 오류:
vox auth whoami로 계정과 워크스페이스를 확인하고, 다시 로그인이 필요하면vox auth login을 실행하세요. - 처음 저장하기 전
diff오류: 새 항목에는 원격 연결 정보가 없어AGENT_BINDING_NOT_FOUND나MANUAL_BINDING_NOT_FOUND가 나와요. 검증 후 처음 저장하고, 그다음 수정부터diff로 비교하세요. - 원격과 로컬 차이:
vox sync status와vox agent diff로 확인하세요. 원격 변경을 가져올 때는 로컬 수정과 비교하세요. - 업데이트:
vox upgrade로 현재 설치 방식에 맞는 업데이트 명령을 확인하세요.
관련 문서
- CLI: 설치와 첫 에이전트 저장
- 에이전트 버전 관리: 버전과 프로덕션 동작
- 메뉴얼: 업무별 응대 절차 구성