> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getporter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 하네스와 Skills로 기능 확장

> 하네스와 Skills를 추가하는 방법을 안내합니다.

<Card>
  하네스는 에이전트 작동 시 파일 생성, Skills 활용 등의 작업 실행을 담당합니다. 기본 내장된 하네스 이외에 Codex CLI, OpenClaw, Hermes 등의 에이전트 서비스를 하네스로 활용할 수 있습니다.
</Card>

<Note>
  애플리케이션 배포 기능으로 하네스를 간편하게 배포하여 활용할 수 있습니다. 아래의 가이드는 Codex CLI를 배포하고 하네스로 추가하는 방법을 예시로 설명합니다.
</Note>

## 하네스 연결 추가하기

### 에이전트 하네스 배포 및 모델 설정

<Steps>
  <Step title="Codex CLI 배포">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/application-harness01.png" />
    </Frame>

    애플리케이션 메뉴의 <Icon icon="circle-plus" iconType="solid" size={15} color="2396F1" /> 또는 `⌘ + K`로 생성되는 배포 창에서  `OpenAI Codex CLI` 템플릿을 선택한 후 `배포하기`를 클릭하세요.
  </Step>

  <Step title="Wrapper Token 조회">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/application-harness03.png" />
    </Frame>

    프로젝트 설정 화면의 시크릿 섹션에서 접속 토큰을 조회할 수 있습니다.
  </Step>

  <Step title="자동 생성된 URL로 접속">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/application-harness04.png" />
    </Frame>

    배포된 서비스 카드의 `접속하기`를 클릭한 후 조회한 Wrapper Token을 입력하면 Codex CLI Control Plane에 접속할 수 있습니다.

    <Tip>
      Codex CLI 접속 주소는 하네스 연결 시 Gateway URL로 사용됩니다.
    </Tip>
  </Step>

  <Step title="인증 및 모델 설정">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/harness04.png" />
    </Frame>

    Control Plane 우측 상단의 `New TUI session`을 클릭하고 인증 및 모델 설정을 마무리합니다.
  </Step>
</Steps>

### Porter AI의 하네스로 연결하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/harness05.png" />
</Frame>

> `설정 > 에이전트` 페이지에서 하네스 연결 `추가하기`를 클릭하고 아래의 설정값을 입력하면 하네스로 등록됩니다.

| 설정 항목             | 설명                                                     |
| :---------------- | :----------------------------------------------------- |
| **이름**            | 하네스 연결의 고유 식별 이름                                       |
| **하네스 종류**        | 연결할 하네스 서비스의 종류를 선택 (예: Codex CLI, OpenClaw, Hermes 등) |
| **Gateway URL**   | 연결할 하네스 서버의 접속 URL                                     |
| **Wrapper Token** | 하네스 인증에 필요한 Wrapper Token 또는 Gateway Token             |
| **Session ID**    | 고정 세션 ID, 입력하지 않으면 Porter 스레드별로 세션 ID가 자동 생성           |
| **Default Model** | 하네스에서 기본으로 사용할 모델 (선택 사항)                              |

## Skills 관리

### Skills 추가하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/skills01.png" />
</Frame>

> `스페이스 설정 > 스킬` 페이지에서 드래그 앤드 드롭 방식으로 스킬을 추가할 수 있습니다.

<Tip>
  `URL로 추가` 버튼을 클릭한 후 `npx skills add 명령어` 또는 `GitHub URL`을 입력하는 방식으로도 Skill을 추가할 수 있습니다.
</Tip>

<AccordionGroup>
  <Accordion title="Porter AI에서는 조직 구성원이 만든 Skills를 조직 전체의 자산으로 활용할 수 있습니다." defaultOpen={true}>
    <AccordionGroup>
      <Accordion title="운영 시스템에서 전역 또는 특정 스페이스를 지정하여 Skills 사용 권한 부여하기">
        [전역 Skills 공유](/ko/enterprise/global-skills) 기능으로 등록한 Skills를 `전체 적용`, `화이트리스트`, `블랙리스트` 방식으로 조직 구성원에게 선택적으로 사용 권한을 부여할 수 있습니다.
      </Accordion>

      <Accordion title="Skills 실행에 필요한 키값을 시크릿으로 함께 관리">
        특정 Skill이 API 키, 토큰, 접속 정보 같은 민감한 값을 필요로 할 때, 그 값을 시크릿 환경 변수로 설정할 수 있습니다. 운영 시스템에서 Skills와 필요한 키값을 시크릿으로 함께 구성해두면, 조직원은 해당 Skill을 활성화하는 것만으로 그 Skill을 사용할 수 있습니다.
      </Accordion>

      <Accordion title="업로드한 Skills를 UI에서 직접 수정하고 즉시 활용">
        등록한 Skills를 열면 편집창에서 내용을 수정할 수 있으며, 매번 다시 업로드하지 않아도 수정된 Skills를 에이전트 작업에 바로 활용할 수 있습니다.
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>

### Skills 편집하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/skills02.png" />
</Frame>

> 등록된 스킬을 클릭한 후 편집기 창에서 파일을 추가하거나 스킬의 내용을 편집할 수 있습니다.

### 접근 권한 설정

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/skills03.png" />
</Frame>

> 스킬 편집기 창의 `권한` 탭에서 스킬을 공유하려는 팀원의 권한을 활성화하는 방식으로 스킬을 공유할 수 있습니다.

<Info>
  Porter AI 엔터프라이즈를 이용하는 경우, 관리자 권한으로 모든 스페이스 또는 특정 스페이스를 지정하여 스킬을 공유할 수 있습니다. 자세한 내용은 [전역 Skills 공유](/ko/enterprise/global-skills)를 참고하세요.
</Info>

## 시크릿 관리

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/skills04.png" />
</Frame>

> 시크릿 섹션에서 매니지드 에이전트가 활용할 수 있는 키값 등의 시크릿을 환경 변수로 주입하여 안전하게 사용할 수 있습니다. 파일 드래그 앤드 드롭 방식으로 여러 개의 시크릿을 한 번에 입력할 수도 있습니다.

<Warning>
  시크릿은 스페이스 단위로 적용되며, 스페이스 소유자만 시크릿을 설정할 수 있습니다. 스페이스에 초대된 사용자는 등록된 시크릿을 사용할 수 있지만 시크릿 메뉴는 표시되지 않습니다.
</Warning>