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

<AccordionGroup>
  <Accordion title="운영 시스템 접속 방법">
    <Frame>
      <img className="block rounded-md" src="https://files.cloudtype.io/ale-docs/ai/images/ko/global-model01.png" />
    </Frame>

    대시보드 우측 상단의 프로필 아이콘을 클릭하면 운영 시스템에 접속할 수 있습니다.

    <Tip>
      [운영 시스템 관리자 권한을 부여](/ko/enterprise/user-management#관리자-권한-부여)받은 사용자 계정으로만 접속 가능합니다.
    </Tip>
  </Accordion>
</AccordionGroup>

## 전역 위젯 추가

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

> 운영 시스템의 MCP・도구 페이지에서 아래의 설정값을 입력하여 전역 위젯을 추가할 수 있습니다.

<div style={{ width: '100%', overflowX: 'auto' }}>
  <table
    style={{
  width: '100%',
  minWidth: '100%',
  tableLayout: 'auto',
  borderCollapse: 'collapse'
}}
  >
    <colgroup>
      <col style={{ width: '20%' }} />

      <col style={{ width: '30%' }} />

      <col style={{ width: '50%' }} />
    </colgroup>

    <thead>
      <tr>
        <th style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>필드</th>
        <th style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>입력값</th>
        <th style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>설명</th>
      </tr>
    </thead>

    <tbody>
      <tr>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>도구 이름</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>LLM이 호출할 도구명</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>소문자, 숫자, 하이픈, 언더스코어만 사용 가능<br />예: <code>book-a-conference-room</code></td>
      </tr>

      <tr>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>제목</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>위젯의 표시명</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>사용자가 어떤 기능인지 알 수 있는 이름을 입력<br />예: <code>회의실 예약</code></td>
      </tr>

      <tr>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>설명</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>위젯이 필요한 상황</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>사용자가 어떤 요청을 했을 때 위젯을 표시할지 설명<br />예: <code>사용자가 회의실 예약을 필요로 할 때 표시합니다.</code></td>
      </tr>

      <tr>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>URL</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>웹서비스 주소</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>iframe으로 렌더링할 웹서비스 URL을 입력<br />예: <code>[https://example.com](https://example.com)</code></td>
      </tr>

      <tr>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>인증</td>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}><code>인증없음</code> 또는 <code>토큰</code></td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>인증에 토큰이 필요한 경우, <code>토큰</code>을 선택하고 아래의 필드에 그 값을 입력</td>
      </tr>

      <tr>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>파라미터</td>
        <td style={{ whiteSpace: 'nowrap', textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>JSON 또는 YAML 객체</td>
        <td style={{ textAlign: 'left', border: '1px solid #d8dee4', padding: '10px 12px' }}>iframe 렌더링 시 위젯에 전달할 추가 값을 입력</td>
      </tr>
    </tbody>
  </table>
</div>

## 적용 범위 설정

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

> 추가한 위젯의 설정창에서 적용 범위 탭을 선택하면 `전체 적용`, `화이트리스트`, `블랙리스트` 방식으로 사용 가능한 스페이스를 선택적으로 설정할 수 있습니다.

<Info>
  권한을 부여받은 스페이스에서 위젯 도구를 호출할 수 있습니다.

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