커스텀 에이전트 공유와 사용 권한

Notion에서 커스텀 에이전트 사용 권한이 작동하는 방식과 Notion AI와 다른 이유에 대해 알아보세요 🤖
자주 묻는 질문(FAQ)으로 이동
Note: Custom Agents are currently in beta and subject to the beta terms of your agreement.
커스텀 에이전트는 Notion 워크스페이스와 연결된 도구 전반에 걸쳐 작업을 자동화합니다. 권한 작동 방식을 이해하면 데이터를 안전하게 보호하면서 에이전트를 안전하게 공유하는 데 도움이 됩니다.
Notion 에이전트와의 주요 차이점:
Notion AI는 사용자를 대신해 작동하며, 개인 권한을 존중합니다. 사용자가 볼 수 있는 내용만 봅니다.
커스텀 에이전트는 고유한 권한을 가진 전문 팀 멤버의 역할을 수행합니다. 사용자가 부여한 특정 리소스에 접근할 수 있습니다.
커스텀 에이전트 권한 사용 방법
커스텀 에이전트에는 두 가지 유형의 권한이 함께 작동합니다.
에이전트가 접근할 수 있는 항목: 에이전트에게 권한을 부여한 특정 Notion 페이지, 데이터베이스, 연결된 앱입니다.
에이전트에 접근할 수 있는 사람: 에이전트를 공유하는 사람과 해당 에이전트로 수행할 수 있는 작업을 의미합니다.

Note: Custom Agents have their own permissions. When you share a Custom Agent, you're giving your team access to everything the agent can see. Agent users can retrieve information from resources they lack access to, or make edits if the agent has read and write permissions to those resources.
Learn how to monitor Custom Agents usage with the Notion credits dashboard.
예:
재무팀이 지출 및 예산 승인에 대한 질문에 답하는 데 도움이 되는 BudgetBot이라는 커스텀 에이전트를 만듭니다.
재무팀은 BudgetBot에게 예산 템플릿, 승인 워크플로, 부서 지출 가이드라인 등 비공개 페이지에 대한 접근 권한을 부여합니다.
재무팀은 부서 리더에게 BudgetBot에 대한
보기 및 상호 작용권한을 부여합니다.BudgetBot에 접근할 수 있는 부서 리더는 이제 해당 페이지에 직접 접근할 수 없더라도 재무팀의 내부 문서를 사용하여 질문하고 답변을 받을 수 있습니다.
이를 통해 부서 리더는 정보에 입각한 결정을 더 빠르게 내릴 수 있습니다. 재무팀의 모든 페이지에 직접 접근할 필요 없이 간단한 요약부터 전체 문서 내용까지 모든 예산 정보를 BudgetBot에 요청할 수 있습니다.
커스텀 에이전트가 접근할 수 있는 항목
커스텀 에이전트를 만들 때 도구 및 사용 권한 설정에서 접근할 수 있는 항목을 명시적으로 선택합니다. 커스텀 에이전트는 다음에 접근할 수 있습니다.
Notion 페이지 및 데이터베이스 - 특정 페이지 또는 데이터베이스를 선택합니다.
연결된 앱 - Slack 채널, MCP, 캘린더, 메일.
권한 수준 - 읽기 허용, 댓글 허용, 편집 허용.
기본적으로 새 에이전트는 워크스페이스의 모든 페이지에 접근할 수 없습니다. 생성자는 이를 명시적으로 활성화하고 경고 모달을 수락해야 합니다.
에이전트는 명시적으로 사용 권한을 부여한 리소스에만 접근할 수 있습니다. 워크스페이스의 다른 항목에는 접근할 수 없습니다. 에이전트 생성자나 사용자 등 누구로부터도 사용 권한을 상속받지 않습니다.
여기에는 데이터베이스 행 권한도 포함됩니다. 커스텀 에이전트는 트리거한 사람의 권한이 아닌 에이전트의 사용 권한을 사용하여 응답합니다. 따라서 에이전트가 최종 사용자보다 더 많은 행을 볼 수 있는 경우, 에이전트는 최종 사용자가 직접 접근할 수 없는 정보를 노출할 수 있습니다.
권한 수준 요구 사항
Notion 리소스에 대한 보기 권한을 부여하려면 해당 리소스에 대한 보기 권한이 있어야 합니다.
보기 권한을 넘어 더 높은 수준의 사용 권한을 부여하려면 해당 리소스를 공유할 수 있는 전체 사용 권한이 있어야 합니다.

Note: Give agents access to only the specific resources they need for their job. Avoid granting workspace-wide access. There isn’t a way to grant higher than “Can View” to all pages in a workspace.
커스텀 에이전트 및 해당 리소스에 접근할 수 있는 사용자
페이지 상단의 공유를 클릭하여 Notion 페이지와 마찬가지로 커스텀 에이전트를 팀과 공유하세요. 커스텀 에이전트에는 누가 사용하고 편집할 수 있는지 결정하는 세 가지 권한 수준이 있습니다.
읽기 및 상호 작용 허용
에이전트를 사용하여 질문을 하거나 작업을 실행합니다.
에이전트의 답변과 결과를 확인합니다.
읽기 전용 모드에서 에이전트 설정 및 지침을 봅니다.
편집 허용
읽기 및 상호 작용 허용의 모든 기능.에이전트 지침을 보고 수정합니다.
사용자가 커스텀 에이전트와 나눈 모든 채팅을 볼 수 있습니다.
Notion 페이지와 데이터베이스를 추가하거나 제거합니다.
설정 및 지침을 편집할 수 있습니다. 단, 다른 사람이 활성화한 제3자 연결은 제외됩니다.
모두 허용
편집 허용의 모든 기능.다른 사람과 에이전트를 공유합니다.
에이전트를 삭제합니다.
API 통합의 경우, Notion은 에이전트를 구성하는 모든 사용자가 편집 중인 리소스에 접근할 수 있는지 확인합니다. 예를 들어, Michael 님이 자신만 액세스할 수 있는 Slack 채널을 설정한 경우, 다른 편집자는 해당 리소스를 편집하거나 볼 수 없으며, 삭제하거나 새로 설정하는 것만 가능합니다.
게스트와 제한된 멤버가 수행할 수 있는 작업:
자신에게 공유된 Notion 페이지 또는 데이터베이스에서 에이전트가 생성한 결과값을 볼 수 있습니다.
이미 구성된 커스텀 에이전트를 실행하도록 트리거할 수 있는 페이지 또는 데이터베이스를 편집합니다.
게스트와 제한된 멤버가 수행할 수 없는 작업:
커스텀 에이전트 생성.
에이전트 설정 편집(명시적으로
편집 허용권한이 부여된 경우 제외).에이전트가 접근할 수 있는 항목에 대해 질문하고 답변 받기.

Note: Before sharing widely, review what resources your agent accesses in Tools and Access and consider whether everyone you’re sharing with should see that information.
워크스페이스 관리자 제어
워크스페이스 관리자는 다음 도구와 제어 기능을 사용하여 조직 전체에서 커스텀 에이전트를 관리할 수 있습니다.

Note: Admins should regularly review agents using these tools, remove unnecessary access, and archive unused agents.
에이전트 디렉토리
워크스페이스에서 모든 커스텀 에이전트를 검색하고 확인합니다.
각 에이전트를 만든 사람과 마지막으로 활성화된 시간을 확인합니다.
에이전트 편집, 채팅, 트리거를 비활성화하고 다시 활성화하여 자동 실행을 중지합니다.
엔터프라이즈 전용: 사용 권한이 없는 경우에도 권한을 변경하고 에이전트를 삭제합니다.
에이전트 디렉토리에 접근하려면 설정으로 이동하여 사이드바에서 Notion AI를 선택하고 에이전트 탭으로 이동하세요. 워크스페이스에서 에이전트를 찾아보거나 검색하세요.

생성 제어
커스텀 에이전트를 생성할 수 있는 사용자를 제한하는 방법:
설정>Notion AI로 이동하세요.에이전트탭으로 들어가서에이전트를 생성할 수 있는 사용자 제어로 이동합니다.에이전트를 생성할 수 있는 사용자를 선택합니다.
워크스페이스 소유자만(기본값),모든 워크스페이스 멤버,워크스페이스 소유자 + 추가된 그룹만.

콘텐츠 관리자 검색
각 커스텀 에이전트가 접근할 수 있는 페이지와 데이터베이스를 확인합니다.
특정 리소스에 대한 에이전트 권한을 관리합니다.
민감한 콘텐츠에 대한 에이전트의 접근 권한을 제거합니다.
콘텐츠 검색에 접근하려면 설정 > 콘텐츠 검색으로 이동하여 공유 대상 필터를 사용하여 커스텀 에이전트를 선택하세요.

Note: Any page or database owner can remove an agent from their resource—even if they don't have access to the agent itself.

감사 로그
모든 커스텀 에이전트 작업의 전체 기록입니다.
에이전트, 사용자, 날짜 또는 작업 유형별로 필터링합니다.
감사 로그에 접근하려면 설정 > 감사 로그로 이동하여 사용자/에이전트 드롭다운에서 에이전트를 선택하여 커스텀 에이전트 이벤트를 필터링하세요.

AI 애널리틱스
가장 많이 사용되는 에이전트와 사용하지 않는 에이전트를 식별합니다.
도입 현황 및 가치를 모니터링합니다.
AI 애널리틱스에 접근하려면 설정 > 애널리틱스로 이동하여 AI탭을 입력하세요.

소유권 이전
소유권을 이전하면 사용자가 워크스페이스를 떠나더라도 비즈니스 핵심 에이전트가 계속 실행됩니다. 소유권이 없는 상태에서 7일이 지나면 에이전트가 실행이 중단됩니다.
설정>멤버로 이동하여최근 나감탭으로 이동하세요.최근에 나간 사용자의 에이전트는 콘텐츠 재프로비저닝 흐름에서 '비공개 에이전트'로 표시됩니다.
새 소유자를 선택하고 이전 작업을 확인합니다.
소유권 이전은 오픈 API를 통해서도 지원됩니다.
자주 묻는 질문(FAQ)
커스텀 에이전트와 Notion AI의 차이점은 무엇인가요?
Notion AI는 사용자를 대신해 작동하며, 개인 권한을 존중하고 사용자가 볼 수 있는 내용만 확인합니다.
커스텀 에이전트는 고유한 권한을 가진 전문 팀 멤버의 역할을 수행합니다. 사용자가 부여한 특정 리소스에 접근할 수 있으며, 에이전트를 사용하는 모든 사용자가 해당 사용 권한을 활용할 수 있습니다.
Notion AI는 온디맨드 방식인 반면, 커스텀 에이전트는 자율적이며 백그라운드에서 자동으로 실행될 수 있습니다.
커스텀 에이전트가 내가 볼 수 없는 항목에 접근할 수 있나요?
네. 다른 사람이 커스텀 에이전트를 공유하는 경우, 해당 에이전트는 사용자가 개인적으로 접근할 수 없는 리소스에 접근할 수 있습니다. 사용자는 에이전트가 응답에 포함한 정보만 볼 수 있습니다. 이는 에이전트가 권한 경계를 넘어 업무를 조율할 수 있도록 설계된 기능입니다.
다만, 해당 리소스에 읽기 및 쓰기 권한이 활성화된 경우 에이전트가 사용자를 대신하여 해당 리소스를 편집할 수 있습니다. 즉, 에이전트에게 정보를 가져오는 것뿐만 아니라 변경하도록 지시할 수도 있습니다.
커스텀 에이전트가 접근할 수 있는 비공개 페이지에서 누군가를 제거하면 어떻게 되나요?
해당 사용자는 해당 페이지에 직접 접근할 수 없게 됩니다. 그러나 여전히 커스텀 에이전트를 계속 사용할 수 있다면 해당 에이전트를 통해 해당 페이지에서 정보를 얻을 수 있습니다.
접근을 완전히 차단하려면 에이전트의 사용 권한에서 페이지를 제거하거나 해당 사용자의 에이전트 접근 권한을 제거하세요.
사용하기 전에 커스텀 에이전트가 접근할 수 있는 리소스를 볼 수 있나요?
읽기 및 상호 작용 허용 권한이 있는 사용자는 연결된 모든 리소스를 보여주는 에이전트의 설정 페이지를 볼 수 있습니다.
에이전트의 설정을 보려면 커스텀 에이전트 페이지를 열고 설정 탭으로 이동하여 도구 및 사용 권한 섹션을 검토하세요.
실수로 에이전트에게 너무 많은 사용 권한을 부여한 경우 어떻게 하나요?
언제든지 에이전트의 도구 및 사용 권한 설정에서 리소스를 제거할 수 있습니다. 변경 사항은 즉시 적용됩니다.
페이지 또는 데이터베이스를 소유하고 있는 경우: 에이전트 자체에 대한 사용 권한이 없더라도 공유 메뉴를 통해 해당 리소스에서 에이전트를 직접 제거하세요.
엔터프라이즈 워크스페이스 소유자인 경우: 에이전트 디렉토리를 사용하여 에이전트를 만들지 않았더라도 에이전트의 권한을 수정할 수 있습니다.
커스텀 에이전트가 내 콘텐츠에 접근하지 못하도록 할 수 있나요?
네. 페이지 또는 데이터베이스 소유자는 공유 메뉴를 통해 리소스에서 커스텀 에이전트를 제거할 수 있습니다.
에이전트를 제거하려면 페이지 또는 데이터베이스를 열고 공유를 클릭한 다음, 목록에서 커스텀 에이전트를 찾아 X를 클릭하여 제거하세요.
에이전트가 내 콘텐츠에 접근하고 있는지 어떻게 알 수 있나요?
커스텀 에이전트는 접근할 수 있는 모든 페이지 또는 데이터베이스의 공유 메뉴에 사람과 마찬가지로 표시됩니다.
확인하려면 페이지 또는 데이터베이스를 열고 공유를 클릭한 다음, 리스트에서 커스텀 에이전트를 찾으세요.
자주 묻는 질문(FAQ)
What's the difference between Custom Agents and Notion AI?
What's the difference between Custom Agents and Notion AI?
Notion AI acts as you—it respects your personal permissions and only sees what you can see.
Custom Agents act as specialized team members with their own permissions. They have access to specific resources you grant them, and anyone who uses the agent can benefit from that access.
Notion AI is on-demand, whereas Custom Agents are autonomous and can run automatically in the background.
Learn more about pricing and how Custom Agents use Notion credits.
Can a Custom Agent access something I can't see?
Can a Custom Agent access something I can't see?
Yes. If someone shares a Custom Agent with you, that agent might have access to resources you don't personally have access to. You only see information the agent includes in its responses. This is by design, allowing agents to coordinate work across permission boundaries.
However, if read and write access is enabled for the resource, the agent can edit those resources on your behalf. This means you can instruct the agent to make changes, not just retrieve information.
What happens if I remove someone from a private page that a Custom Agent can access?
What happens if I remove someone from a private page that a Custom Agent can access?
The person will lose direct access to that page, but if they can still use the Custom Agent, they might be able to get information from that page through the agent.
If you want to fully prevent access, either remove the page from the agent's access, or remove that person's access to the agent.
Can I see what resources a Custom Agent has access to before using it?
Can I see what resources a Custom Agent has access to before using it?
Anyone with Can view and interact permission can see the agent's settings page, which shows all connected resources.
To view an agent's settings, open the Custom Agent page, go to the Settings tab, and review the Tools and access section.
What if I accidentally give an agent too much access?
What if I accidentally give an agent too much access?
You can remove resources from an agent's Tools and Access settings at any time. The changes take effect immediately.
If you own a page or database: Remove the agent from that resource directly through the share menu—even if you don't have access to the agent itself.
If you're an Enterprise workspace owner: Use the Agent Directory to modify any agent's permissions, even if you didn't create it.
Can I stop a Custom Agent from accessing my content?
Can I stop a Custom Agent from accessing my content?
Yes. As a page or database owner, you can remove any Custom Agent from your resource through the share menu.
To remove an agent, open the page or database, click Share, find the Custom Agent in the list, and click the X to remove it.
How do I know if an agent is accessing my content?
How do I know if an agent is accessing my content?
Custom Agents appear in the share menu of any page or database they have access to—just like people do.
To check, open the page or database, click Share, and look for Custom Agents in the list.
