> ## 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.

# 커스텀 에이전트와 봇 구성 및 공유

> 커스텀 에이전트와 봇을 추가하고 공유하는 방법을 안내합니다.

<Card>
  특정 업무에 필요한 지식과 도구를 커스텀 에이전트 또는 봇으로 구성해 스페이스에 초대한 팀원과 공유할 수 있습니다.
</Card>

<Tip>
  [운영 시스템에서는 전역 또는 특정 스페이스를 지정하여 커스텀 에이전트와 봇을 추가](/ko/enterprise/global-agents)할 수 있습니다.
</Tip>

## 커스텀 에이전트 추가하기

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

> `스페이스 설정 > 에이전트・봇` 페이지에서 `에이전트 추가하기` 버튼으로 커스텀 에이전트를 추가하면, 채팅창에서 에이전트를 선택하는 방식으로 사용할 수 있습니다.

<Tip>
  에이전트별로 프로필 이미지를 설정하면 필요한 에이전트를 쉽게 식별하고 선택할 수 있습니다.
</Tip>

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

<AccordionGroup>
  <Accordion title="커스텀 에이전트 설정 사항" defaultOpen={true}>
    <AccordionGroup>
      <Accordion title="샌드박스 환경에서 작업을 수행할 하네스 설정">
        <Frame>
          <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/default-agent02.png" />
        </Frame>

        <Steps>
          <Step title="하네스 연결">
            파일 생성, Skills 활용 등의 작업을 위한 에이전트 실행에 사용할 하네스 커넥션을 선택합니다. 기본 내장된 Anthropic과 OpenAI의 매니지드 에이전트 또는 추가된 하네스를 선택할 수 있습니다.

            <Note>
              OpenClaw, Hermes, Codex 등의 하네스를 추가하는 방법은 [하네스와 Skills로 기능 확장](/ko/harness-and-skills) 페이지를 참고하세요.
            </Note>
          </Step>

          <Step title="하네스 모델 선택">
            선택한 하네스의 모델을 선택합니다. `자동`으로 선택할 경우 설정된 `default` 모델이 적용됩니다.
          </Step>

          <Step title="위임 설정">
            `하네스가 대화 전체를 직접 실행` 토글을 켤 경우, 모든 작업을 하네스에서만 수행합니다. 토글을 끄면 파일 생성, Skills 활용 등 하네스가 필요한 작업만 하네스에게 위임됩니다.
          </Step>
        </Steps>
      </Accordion>

      <Accordion title="오케스트레이션 모델 설정 ">
        오케스트레이션 모델은 요청받은 작업의 처리를 지휘하며, 전체 작업 중 하네스가 필요한 부분을 하네스에게 위임합니다. 설정으로 오케스트레이션 루프의 최대 턴 수를 지정할 수 있습니다.

        <Info>
          하네스 연결 시 `하네스가 대화 전체를 직접 실행`하도록 설정한 경우, 모든 작업을 하네스가 수행하며 오케스트레이션 모델 설정이 필요 없습니다.
        </Info>

        <Accordion title="오케스트레이션 모델 세부 설정">
          <AccordionGroup>
            <Accordion title="기본 모델">
              오케스트레이션 모델을 설정하지 않을 경우 선택된 기본 모델 또는 스페이스의 기본 모델이 적용됩니다.
            </Accordion>

            <Accordion title="요약 모델">
              대화 맥락을 기반으로 스레드의 제목을 자동 생성하는 모델입니다.
            </Accordion>

            <Accordion title="이미지 모델">
              사용자가 이미지 생성을 요청할 경우, 내장된 이미지 생성 도구(Tool)의 이미지 모델을 설정할 수 있습니다.
            </Accordion>

            <Accordion title="생각 강도">
              추론(Reasoning) 기능을 지원하는 모델의 사고 단계 깊이를 설정합니다.
            </Accordion>
          </AccordionGroup>
        </Accordion>
      </Accordion>

      <Accordion title="지식베이스, MCP 서버, Skills 등 활용할 도구 설정">
        에이전트가 업무를 수행할 때 활용할 도구를 추가합니다. 스페이스에서 직접 설정한 도구와 운영 시스템에서 전역으로 공유된 도구를 에이전트가 활용할 수 있습니다.

        ### 시스템 도구

        Porter AI에 기본으로 내장된 도구 중 에이전트가 사용할 도구를 선택합니다. 활성화된 도구는 사용자의 요청을 처리하는 데 필요한 경우 에이전트가 자동으로 호출합니다.

        <Accordion title="지원하는 시스템 도구 목록">
          | 시스템 도구      | 기능                                 |
          | ----------- | ---------------------------------- |
          | 웹 검색        | 웹에서 최신 정보를 검색합니다.                  |
          | 웹페이지 생성     | 요청에 맞는 웹페이지(HTML)를 생성합니다.          |
          | 번역          | 문서 또는 텍스트를 다른 언어로 번역합니다.           |
          | 웹페이지 조회     | 특정 URL의 웹페이지 또는 YouTube 내용을 가져옵니다. |
          | 이미지 생성      | 프롬프트로 이미지를 생성합니다.                  |
          | 이미지 편집      | 기존 이미지를 프롬프트로 수정합니다.               |
          | 지식베이스 검색    | 활성화된 지식베이스에서 관련 항목을 검색합니다.         |
          | 지식베이스 본문 조회 | 검색된 지식베이스 항목의 본문을 조회합니다.           |
          | 기억 검색       | 장기 기억에서 항목을 검색하거나 나열합니다.           |
          | 기억 조회       | 장기 기억 항목의 본문을 조회합니다.               |
          | 기억 저장       | 장기 기억에 새 항목을 저장합니다.                |
          | 기억 수정       | 기존 장기 기억 항목을 갱신합니다.                |
          | 기억 삭제       | 장기 기억 항목을 삭제합니다.                   |
        </Accordion>

        ### MCP 서버

        MCP 서버 또는 REST API를 연결하면 에이전트가 사내 업무 시스템 또는 외부 도구의 데이터를 조회하거나 등록·수정 작업을 수행할 수 있습니다.

        <CardGroup cols={2}>
          <Card title="MCP 서버로 업무 시스템 연결" icon="https://mintcdn.com/prommai/u9eU40v8NBdPAgVy/images/icons/mcp.svg?fit=max&auto=format&n=u9eU40v8NBdPAgVy&q=85&s=1a3e13b181464fd606465ba45bb48738" href="/ko/mcp" horizontal width="24" height="24" data-path="images/icons/mcp.svg" />

          <Card title="REST API를 AI의 도구로 등록" icon="plug" href="/ko/tools" horizontal />
        </CardGroup>

        ### 지식베이스

        사내 문서, 업무 자료, 규정과 같은 대규모 문서 파일 기반의 지식을 에이전트의 답변과 작업에 활용할 수 있습니다.

        <Card title="문서 지식베이스(에이전틱 RAG)" icon="book" href="/ko/rag" horizontal />

        ### 커넥터

        데이터베이스, 협업 도구 등 조직에서 사용하는 서비스와 데이터를 에이전트가 활용할 수 있습니다.

        <CardGroup cols={2}>
          <Card title="DB와 벡터DB 연결" icon="database" href="/ko/database" horizontal />

          <Card title="Notion 지식 연동" icon="notion" href="/ko/notion" horizontal />

          <Card title="Linear 연동" icon="https://mintcdn.com/prommai/u9eU40v8NBdPAgVy/images/icons/linear.svg?fit=max&auto=format&n=u9eU40v8NBdPAgVy&q=85&s=25b1d18d65678cd527942e75386c7d4d" href="/ko/linear" horizontal width="24" height="24" data-path="images/icons/linear.svg" />

          <Card title="Jira 워크스페이스 연동" icon="jira" href="/ko/jira" horizontal />
        </CardGroup>

        ### Skills와 시크릿

        추가된 Skills를 활성화하고, 필요한 시크릿을 환경 변수로 추가하면 하네스가 스킬을 활용하여 작업을 수행합니다.

        <Card title="Skills 설정 " icon="screwdriver-wrench" href="/ko/harness-and-skills" horizontal />
      </Accordion>

      <Accordion title="에이전트에 대한 시스템 프롬프트 주입">
        에이전트가 사용될 때 시스템 프롬프트에 추가할 지시 사항을 설정할 수 있습니다.

        <Tip>
          다양한 도구를 활성화한 경우, 그 활용법을 설명하면 더 좋은 결과물을 얻을 수 있습니다.
        </Tip>
      </Accordion>
    </AccordionGroup>
  </Accordion>
</AccordionGroup>

## 봇 추가하기

> 봇 섹션에서 봇을 추가할 수 있습니다. `기억 모드`에 대한 설정 이외에는 커스텀 에이전트 설정과 동일합니다.

| 기억 모드     | 설명                          |
| :-------- | :-------------------------- |
| **공유 기억** | 하나의 스레드로 모든 구성원과 맥락을 공유합니다  |
| **개인 기억** | 사용자마다 별도의 스레드로 각자 맥락을 유지합니다 |

<Tip>
  봇을 추가하면 좌측 사이드바의 전용 대화 세션에서 작업 맥락을 유지하며 작업을 수행하며, **사용자는 봇을 업무를 함께 수행하는 조수처럼 활용할 수 있습니다.**

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

## 팀원 초대 및 공유 설정

### 팀원 초대하기

<Frame>
  <img className="block rounded-md" src="https://files.cloudtype.io/promm/images/ko/user01.png" />
</Frame>

> `스페이스 설정 > 팀`에서 `초대하기`를 클릭하면 이메일로 팀원을 초대할 수 있습니다. Porter AI에 가입된 사용자는 자동으로 팀원으로 추가되며, 미가입 사용자에게는 초대 메일이 발송됩니다.

<Info>
  스페이스는 Porter AI의 워크스페이스 단위입니다. 한 명이 단독으로 사용하거나 다른 사용자를 초대해 공용 스페이스로 사용할 수 있으며, 에이전트, 봇, 지식베이스, Skills, MCP 서버 등을 공유할 수 있습니다.
</Info>

<Tip>
  초대한 팀원에게 스페이스에 대한 권한을 부여할 수 있습니다.

  | 권한      | 설명                                  |
  | :------ | :---------------------------------- |
  | **소유자** | 스페이스를 개설한 사용자로 관리자 권한을 갖습니다.        |
  | **관리자** | 팀원 초대, 에이전트 설정 등 모든 관리 권한을 갖습니다.    |
  | **멤버**  | 관리자가 공유한 기능과 직접 설정한 기능을 사용할 수 있습니다. |
</Tip>

### 에이전트와 봇 공유하기

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

> 추가한 에이전트와 봇은 활성화해야 사용할 수 있으며, 설정창의 권한 탭에서 팀원별로 사용 권한을 부여할 수 있습니다.

<Tip>
  [운영 시스템에서는 전역 또는 특정 스페이스를 지정하여 커스텀 에이전트와 봇을 추가](/ko/enterprise/global-agents)할 수 있습니다.
</Tip>