> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-guide/integrations/org-integration.md).

# 조직도 연동

{% hint style="success" %}
조직도 연동은 필수가 아니고 **도입 후 사후적으로 연동 가능**합니다. 따라서 **빠른 도입**을 위해서는 **우선 조직도 연동 없이 도입**하시고, 직원들이 웍스AI를 충분히 잘 쓰게 되었을 때 **사후적으로 연동**하시는 것을 권장드립니다.
{% endhint %}

기업들은 **웍스AI와 조직도를 연동**할 수 있습니다. 조직도를 연동하시면 에이전트를 **본부 단위**, 그 아래 **사업실 단위**, 그 아래 **팀 단위**, 그 아래 **T/F나 파트 단위** 등으로 자유롭게 공유할 수 있습니다. 또한 본부에 에이전트를 공유할 경우, 본부 아래에 있는 **모든 하위 조직**은 **해당 에이전트를 모두 사용**할 수 있게 됩니다.

**전사 단위 에이전트**만 만들 수 있는 **다른 회사들 대비** 훨씬 더 민감한 **우리 부서만 알아야 하는 파일** 같은 것을 올려두고 **우리 부서원들끼리만 이용하는 에이전트**를 운용할 수 있습니다.

**회사마다 모두 다른 각자의 위계에 따라 완전히 유연하게 에이전트를 공유**할 수 있게 되어 AI를 활용하는 **전사 생산성을 높일** 수 있습니다.

<figure><img src="https://285569235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVUV1kKgqv1vX6LI7NOQx%2Fuploads%2Fgit-blob-4e4ef666b64a61d7c584356ca4fa4bbc92df9b00%2FScreenshot%202025-04-03%20at%208.42.18%E2%80%AFPM.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

공식 에이전트의 공유는 **에이전트 카테고리 단위**로 아래 그림과 같이 **\[관리자]-\[에이전트 관리]** 메뉴에서 **관리자**가 **특정 에이전트 카테고리(아래 그림에서는 '업무' 탭)**&#xC758; '**공개 범위**'를 눌러 설정할 수 있습니다.

<figure><img src="https://285569235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVUV1kKgqv1vX6LI7NOQx%2Fuploads%2Fgit-blob-0602f5f7bed1de5a607174cb81be062197018d47%2Fa-03.png?alt=media" alt="" width="563"><figcaption><p>‘공개 범위’를 설정하면 공유된 부서의 하위 조직 소속 인원에게만 그 에이전트 카테고리가 보입니다.</p></figcaption></figure>

모든 에이전트 카테고리는 '**전체 공개**'로 기본 설정되어 있습니다. 이를 '**일부 공개**'로 바꾸면 **초대할 사용자(이름·이메일) 또는 조직**을 입력해 추가할 수 있습니다. **복수로 선택 가능**하며 **하나의 에이전트 카테고리**를 **여러 유관 부서에 공유**해 줄 수 있습니다. 아예 감추시려면 '**비공개**'를 고르시면 됩니다.

**상위 부서**에 공유된 **에이전트 카테고리**는 **하위 부서**에 속한 모든 **임직원들**에게도 **보이고 이용 가능**합니다.

위 예시에서는 (어디까지나 예시이기 때문에) '**본사/경영지원본부/법무실/컴플라이언스팀**'과 '**본사/경영지원본부/법무실**'을 함께 선택해 놓았지만, 실제 쓰실 때는 **그렇게 하실 필요가 없습니다.**

'**본사/경영지원본부/법무실**'만 선택해 공유해 놓아도, **그 하위 부서**인 **'본사/경영지원본부/법무실/컴플라이언스팀**' 소속 임직원도 모두 이 에이전트 카테고리를 이용할 수 있게 됩니다.

**내가 속한 부서(및 그 상위 부서)**&#xC5D0; 공유되어 있는 **에이전트 카테고리**는 웍스AI 서비스 메인의 **\[내게 공유된 에이전트]** 탭을 누르시면 **확인하고 이용**하실 수 있습니다. 아래 그림은 **\[법무]** 카테고리가 공유되어 있는 모습입니다. **이 카테고리는 우리 회사의 다른 부서(공유 받지 못한 부서)에 속한 임직원에게는 보이지 않습니다.**

이렇게 사용하면 **우리 회사 조직도에 따라** 완전히 자유롭고 **유연하게 에이전트를 만들어 부서 단위로 공유**해 줄 수 있습니다.

{% hint style="info" %}
카테고리 단위 공유 외에, **부서를 선택해 만들면 해당 부서 구성원이 함께 쓰고 수정할 수 있는 개별 에이전트(팀 에이전트)** 도 운용하실 수 있어요. 다만 사용자에게 **부서 정보가 없으면 팀 에이전트 탭 자체가 보이지 않으니** 부서 설정을 먼저 해주셔야 합니다. 자세한 내용은 [팀 에이전트 관리](https://docs.wrks.ai/admin-guide/admin-agents/team-agents) 페이지를 참고해 주세요.
{% endhint %}

또한 조직도를 연동해 사용하는 회사들은 [**위계별로 자세한 부서별 이용 통계**](https://docs.wrks.ai/release-notes#id-2025.07.15)를 확인하실 수 있습니다.

조직도를 그리면 **부서 단위 요금 한도**도 설정할 수 있게 됩니다. **부서 총한도(월 전체 요금 한도)** 와 **부서 내 개인 한도(월 사용자별 요금 한도)** 를 각각 정할 수 있고, **상위 부서의 한도는 하위 부서에 자동 적용됩니다.**

연동을 희망하시는 기업들은 이 [**기업 사용자용 API 이용가이드**](https://wrks.ai/ko/docs/departments) 내 **부서 관리** 를 참고해주시길 바랍니다.

감사합니다.

***

## 부서 관리 화면

조직도는 `관리자 > 부서 관리` 에서 만듭니다. API 연동 없이 **CSV 로 일괄 수정**하실 수도 있어요.

{% hint style="warning" %}
CSV로 일괄 수정하실 때 파일의 컬럼은 **부서코드 · 부서명 · 상위부서코드** 세 가지예요. **최상위 부서의 상위부서코드 칸은 반드시 공백(빈값)** 으로 두셔야 합니다.
{% endhint %}

{% hint style="info" %}
부서 관리 화면의 자세한 따라하기(조직도 만들기, \[부서 일괄 수정] 등)는 [부서 관리](https://docs.wrks.ai/admin-guide/admin-org/departments) 페이지에서 안내하고 있어요.
{% endhint %}

<figure><img src="https://285569235-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVUV1kKgqv1vX6LI7NOQx%2Fuploads%2Fgit-blob-77cc825c27af0683c8e7e94e6073d75aea0694e3%2Fp-dept-01.png?alt=media" alt=""><figcaption><p>부서 관리</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/admin-guide/integrations/org-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.