하네스는 에이전트 작동 시 파일 생성, Skills 활용 등의 작업 실행을 담당합니다. 기본 내장된 하네스 이외에 Codex CLI, OpenClaw, Hermes 등의 에이전트 서비스를 하네스로 활용할 수 있습니다.
앱 배포 플랫폼에서 하네스를 간편하게 배포하여 Porter AI의 하네스로 활용할 수 있습니다. 아래의 가이드는 앱 배포 플랫폼에서 배포한 Codex CLI를 Porter AI의 하네스로 추가하는 방법을 예시로 설명합니다.
하네스 연결 추가하기
에이전트 하네스 배포 및 모델 설정
앱 배포 플랫폼에서 배포할 수 있는 Codex CLI 템플릿을 기준으로 설명합니다.
1
Codex CLI 배포
OpenAI Codex CLI 템플릿을 선택한 후 배포하기 를 클릭하면 Codex CLI가 클라우드 환경에서 배포됩니다.앱 배포 플랫폼 접속 방법
앱 배포 플랫폼 접속 방법
기본 접속 주소인
app.도메인의 서브도메인을 idp.도메인으로 변경하면 앱 배포 플랫폼에 접속할 수 있습니다.2
Wrapper Token 조회
하네스가 사용할 시크릿을 환경변수로 주입할 수 있습니다. 자세한 내용은 환경변수와 시크릿 관리 페이지를 참고하세요.
3
자동 생성된 URL로 접속
접속하기를 클릭한 후 조회한 Wrapper Token을 입력하면 Codex CLI Control Plane에 접속할 수 있습니다.4
인증 및 모델 설정
New TUI session을 클릭하고 인증 및 모델 설정을 마무리합니다.Porter AI의 하네스로 연결하기
설정 > 에이전트페이지에서 하네스 연결추가하기를 클릭하고 아래의 설정값을 입력하면 하네스로 등록됩니다.
Skills 관리
Skills 추가하기
스페이스 설정 > 스킬 페이지에서 드래그앤 드롭 방식으로 스킬을 추가할 수 있습니다.
Porter AI에서는 조직 구성원이 만든 Skills를 조직 전체의 자산으로 활용할 수 있습니다.
Porter AI에서는 조직 구성원이 만든 Skills를 조직 전체의 자산으로 활용할 수 있습니다.
AI 운영시스템에서 전역 또는 특정 스페이스를 지정하여 Skills 사용 권한 부여하기
AI 운영시스템에서 전역 또는 특정 스페이스를 지정하여 Skills 사용 권한 부여하기
전역 Skills 공유 기능으로 등록한 Skills를
전체 적용, 화이트리스트, 블랙리스트 방식으로 조직 구성원에게 선택적으로 사용 권한을 부여할 수 있습니다.Skills 실행에 필요한 키값을 시크릿으로 함께 관리
Skills 실행에 필요한 키값을 시크릿으로 함께 관리
특정 Skill이 API 키, 토큰, 접속 정보 같은 민감한 값을 필요로 할 때, 그 값을 시크릿 환경변수로 설정할 수 있습니다. AI 운영시스템에서 Skills와 필요한 키값을 시크릿으로 함께 구성해두면, 조직원은 해당 Skill을 활성화하는 것만으로 그 Skill을 사용할 수 있습니다.
업로드한 Skills를 UI에서 직접 수정하고 즉시 활용
업로드한 Skills를 UI에서 직접 수정하고 즉시 활용
등록한 Skills를 열면 편집창에서 내용을 수정할 수 있으며, 매번 다시 업로드하지 않아도 수정된 Skills를 에이전트 작업에 바로 활용할 수 있습니다.
Skills 편집하기
등록된 스킬을 클릭한 후 편집기 창에서 파일을 추가하거나 스킬의 내용을 편집할 수 있습니다.
접근 권한 설정
스킬 편집기 창의 권한 탭에서 스킬을 공유하려는 팀원의 권한을 활성화하는 방식으로 스킬을 공유할 수 있습니다.
Porter AI 엔터프라이즈를 이용하는 경우, 관리자 권한으로 모든 스페이스 또는 특정 스페이스를 지정하여 스킬을 공유할 수 있습니다. 자세한 내용은 전역 Skills 공유를 참고하세요.
시크릿 관리
시크릿 섹션에서 매니지드 에이전트가 활용할 수 있는 키값 등의 시크릿을 환경변수로 주입하여 안전하게 사용할 수 있습니다. 파일 드래그앤 드롭 방식으로 여러 개의 시크릿을 한 번에 입력할 수도 있습니다.