커스텀 에이전트
커스텀 에이전트를 사용하면 반복되는 팀 작업을 자동화하는 공유 워크플로를 구축할 수 있으며, 정확히 필요에 맞게 설정된 방식으로 백그라운드에서 실행됩니다. 🤖
자주 묻는 질문(FAQ)으로 이동
커스텀 에이전트는 현재 베타 버전으로 지원되며, 베타 약관이 적용됩니다.
커스텀 에이전트는 팀 전체의 반복적인 수동 워크플로를 자동화합니다. 기존 문서와 데이터베이스를 맥락으로 활용하여, 설정된 트리거에 따라 백그라운드에서 자동으로 실행됩니다.
주간 리포트 작성이나 피드백 분류와 같은 반복 작업을 위한 워크플로를 한 번만 설정해 두면, 팀 전체가 공유하는 리소스로 활용할 수 있습니다.
커스텀 에이전트란 무엇인가요?
커스텀 에이전트는 Notion 내에서 작동하며, 사용자의 지침에 따라 실행됩니다. 설정이 완료되면, 커스텀 에이전트는 다음을 수행할 수 있습니다.
Notion 페이지와 데이터베이스 및 연결된 특정 앱에서 정보를 확인합니다.
반복 트리거와 워크스페이스 이벤트에 따라 실행됩니다.
리포트 게시, 버그 제출, 기록 업데이트 또는 메시지 전송과 같은 작업을 수행합니다.
커스텀 에이전트는 Notion 에이전트와는 다르게 트리거와 일정을 기반으로 백그라운드에서 자동으로 실행되도록 설계되었습니다.
기존 문서와 데이터베이스를 맥락으로 사용합니다.
커스텀 에이전트는 Notion에 직접 내장되어 있습니다. 에이전트는 기존 문서와 데이터베이스를 맥락으로 활용하고 Slack과 연동되어 생산성을 높입니다. 커스텀 에이전트로 다음을 수행할 수 있습니다.
Notion 페이지, 데이터베이스 속성 및 댓글에서 에이전트를
@멘션합니다.커스텀 에이전트를 데이터베이스 이벤트(예: 페이지가 생성되거나 업데이트될 때)에 연결하세요.
설정한 트리거에 따라 워크스페이스와 연결된 도구를 모니터링하도록 설정할 수 있습니다.
트리거를 사용하여 반복되는 작업을 자동으로 처리합니다.
트리거를 사용하면 커스텀 에이전트를 매번 수동으로 시작하지 않아도 자동으로 실행할 수 있습니다. 트리거를 한 번만 설정하면 백그라운드에서 작업이 연속적으로 실행됩니다.
일정에 따라 실행됩니다(매일, 매주, 매월 등).
Notion과 Slack에서 이벤트에 반응합니다.
게시 후에는 백그라운드에서 계속 실행됩니다.
이를 통해 정기 리포트 작성, 대기열 분류, 지식 유지관리와 같은 자동화된 워크플로를 구현할 수 있으므로, 시간을 절약하는 데 도움이 됩니다.
안전하고 투명한 설계
에이전트는 사용자가 명시적으로 사용 권한을 부여한 페이지, 데이터베이스, 외부 앱에서만 작동합니다. 기본적으로 전체 워크스페이스에 대한 사용 권한은 없으므로, 위험을 줄일 수 있습니다.
각 에이전트를 편집, 실행 또는 상호 작용할 수 있는 사용자를 제어합니다.
활동 로그를 확인하여 에이전트가 언제 어떤 작업을 수행했는지 확인합니다.
버전 기록을 사용하여 이전 구성을 검토하거나 복원합니다.
안전하게 반복할 수 있도록 실행을 검토하고 되돌릴 수 있도록 유지합니다.
Notion의 비즈니스 또는 엔터프라이즈 요금제를 구독 중이라면 커스텀 에이전트를 사용할 수 있습니다. 커스텀 에이전트 가격에 관해 자세히 알아보세요.
데스크톱이나 웹을 사용하여 커스텀 에이전트를 구축, 편집, 확인하거나 커스텀 에이전트와 상호 작용할 수 있습니다.
커스텀 에이전트는 여러 위치에서 구축할 수 있습니다. 주요 진입점은 사이드바의 에이전트 섹션입니다.
사이드바의
에이전트섹션으로 이동해+기호를 선택하여 새 커스텀 에이전트를 만듭니다.
2. 시작 방법을 선택하세요.
AI 채팅으로 생성하기
채팅 창에서, 에이전트가 수행하기를 원하는 작업을 자연어를 사용하여 설명하세요.
Notion AI가 생성한 초안 지침, 트리거, 사용 권한을 검토하고 반복적으로 개선하세요.
저장하세요.
템플릿에서 만들기
탬플릿을 선택하세요.
Notion AI가 생성한 초안 지침, 트리거, 사용 권한을 검토하고 반복적으로 개선하세요.
저장하세요.
처음부터 만들기
빈 페이지 만들기를 선택하세요.빈 지침 필드에서 시작하거나 채팅을 시작하세요.
명확하고 구체적인 지침을 위한 모범 사례에 따라 지침을 수동으로 작성하세요. 에이전트가 해야 할 일, 행동 방식, 처리해야 할 일을 정의하세요.
내 워크플로에 맞춰 트리거, 사용 권한, AI 모델을 설정하세요.
저장하세요.

에이전트에 대한 명확한 지침을 생성하려면 원하는 작업과 결과를 정의하는 것부터 시작합니다. 그런 다음 구체적인 단계, 입력, 출력을 추가하세요. 예시가 있으면 이를 사용합니다.
팁: 커스텀 에이전트 템플릿을 출발점으로 사용합니다.
에이전트가 실행되는 시기는 트리거가 결정합니다. 단일 에이전트에 대해 여러 트리거 유형을 결합할 수 있습니다.
반복되는 시간 기반 일정으로 워크플로 자동화하기
반복되는 일정을 사용하여 일정한 주기로 에이전트를 실행하세요.
커스텀 에이전트의
설정을 여세요.트리거섹션으로 이동하세요.반복트리거를 추가하세요.에이전트를 실행할 시기를 선택하세요.
빈도(매일, 매주, 매월 또는 매년)를 선택하세요.
시간대를 포함하여 특정 시간(예: '매일 자정 PST')을 설정하세요.
예정된 다음 실행 시간을 검토하여 일정이 올바른지 확인하세요.
트리거를 저장하세요.
Notion 트리거 사용하기
Notion 트리거는 워크스페이스의 이벤트를 기반으로 에이전트를 실행합니다. 다음과 같은 경우 에이전트를 트리거할 수 있습니다.
페이지에 댓글이 추가되는 경우.
데이터베이스에 페이지가 추가되는 경우.
데이터베이스에서 페이지가 업데이트되는 경우.
데이터베이스에서 페이지가 제거되는 경우.
페이지 또는 댓글에서 커스텀 에이전트가 @멘션되는 경우.
Notion 트리거를 추가하려면 다음 단계를 따르세요.
커스텀 에이전트의
설정을 열고트리거를 선택하세요.Notion트리거 유형을 선택하세요.다음 사항을 지정하세요.
모니터링할 페이지 또는 데이터베이스.
이벤트(예: '데이터베이스에서 생성된 페이지').
사용 가능한 경우 추가 필터 또는 조건.
저장하세요.
Slack 트리거 사용하기
Slack 트리거를 사용하면 에이전트가 공개 Slack 채널에서 이벤트를 모니터링할 수 있습니다. 비공개 채널은 지원되지 않습니다.
설정 요구 사항
Slack 트리거를 설정하려면 먼저 Slack 워크스페이스 관리자가 커스텀 에이전트의 Notion API 통합을 활성화해야 합니다. 이렇게 하면 커스텀 에이전트가 Slack에서 작동하는 데 필요한 읽기 및 쓰기 권한이 해당 에이전트에 부여됩니다. API 통합이 활성화되면 새 메시지나 이모지 반응에 따라 트리거를 구성할 수 있습니다.
에이전트가 감시할 수 있는 사항:
채널에 게시된 메시지
메시지에 추가된 이모지 반응
채널에서 시작된 스레드
메시지에 멘션된 커스텀 에이전트
참고: Slack에서 멘션을 통해 에이전트를 트리거하려면 먼저 모든 멤버가 사용자 그룹을 생성할 수 있도록 Slack 워크스페이스 관리자가 이를 허용해야 합니다. 이 설정이 활성화되면 누구나 연동된 Slack 채널의 해당 이름을 멘션하여 에이전트를 트리거할 수 있습니다.
Slack 트리거를 추가하려면 다음 단계를 따르세요.
아직 연결하지 않았다면, 설정 과정에서 Slack을 에이전트에 연결하세요.
트리거에서Slack트리거를 추가하세요.다음 사항을 선택하세요.
이벤트 유형.
모니터링할 채널.
사용 가능한 경우 추가 필터 또는 조건.
저장하세요.

참고:
Slack에서 이름별로 커스텀 에이전트를 @멘션하려면 멤버가 사용자 그룹을 생성할 수 있도록 Slack 워크스페이스 소유자가 이를 허용해야 합니다. 이 조건은 Slack의 요구 사항이며 Notion 설정과는 관련이 없습니다.
Slack에서는 저장된 메시지 또는 '나중에' 메시지 기능이 지원되지 않습니다.
커스텀 에이전트는 사용자가 명시적으로 사용 권한을 부여한 콘텐츠만 작업에 사용합니다. 각 에이전트의 사용 권한 설정에서 이를 구성하세요.
워크스페이스의 콘텐츠에 대한 사용 권한을 커스텀 에이전트에 부여하세요.
에이전트가 Notion에서 볼 수 있는 내용을 제어하려면 다음 단계를 따르세요.
커스텀 에이전트의
설정을 여세요.도구 및 사용 권한섹션으로 이동하세요.에이전트가 맥락으로 사용할 특정 페이지 또는 데이터베이스를 추가하세요.
대상 워크플로에 맞는 집중된 페이지와 데이터베이스를 추가하세요(예: '고객 티켓', '버그', '사고').
워크스페이스 전체의 콘텐츠를 포함하는 광범위한 범위를 원하는 경우
Notion의 모든 사용자와 공유된 페이지에 대한 사용 권한을 부여하세요.
더 좁은 범위를 원하는 경우 사용 권한을 '
없음' 또는 작은 페이지의 집합으로 제한하세요.

에이전트 지침에서 Notion 페이지로 연결해도 연결된 도구 및 사용 권한에는 추가되지 않습니다.
웹 접근 허용 또는 차단하기
필요한 경우 에이전트는 선택적으로 웹을 탐색할 수 있습니다. 워크플로가 외부 정보에 의존하는 경우 웹 접근을 사용하세요. 엄격하게 내부 워크플로에만 사용하거나, 정보 출처에 대해 더 엄격한 통제가 필요한 경우에는 비활성화 상태로 유지하세요. 웹 접근을 제어하려면 다음 단계를 따르세요.
에이전트의
설정을 여세요.웹 접근토글을 찾으세요.에이전트가 인터넷에서 정보를 검색할 수 있도록 웹 접근을
활성화하세요.웹 접근을
비활성화하여 에이전트를 Notion 및 구성된 앱으로만 제한하세요.
커스텀 에이전트에 Slack 사용 권한 부여하기
커스텀 에이전트는 전용 API 통합을 통해 Slack에서 정보를 읽고 게시할 수 있습니다. Slack을 커스텀 에이전트에 연결하기 전에 관리자는 먼저 Notion AI 설정을 통해 Slack AI 커넥터를 워크스페이스에 연결해야 합니다. 에이전트는 다음과 같은 작업을 수행할 수 있습니다.
공개 채널에서 읽기.
채널에 메시지, 답글, 업데이트 게시.
스레드에 반응하고 Slack의 정보를 맥락으로 사용.

비공개 메시지와 Slack Grid는 현재 지원되지 않습니다.
Slack을 연결하려면 다음 절차를 따르세요.
에이전트를 설정할 때 안내에 따라 Slack을 연결하세요.
Slack 계정에서 Notion 계정과 동일한 이메일을 사용하고 있는지 확인하세요.
Slack의 인증 흐름에서 요청된 범위를 승인하세요.
에이전트가 접근할 수 있는 채널을 선택하세요.
커스텀 에이전트는 다양한 대규모 언어 모델에서 실행할 수 있습니다. 이렇게 하면 속도, 비용 및 품질의 균형을 맞출 수 있습니다. 워크플로가 변경되거나 성능 요구 사항이 다른 경우 시간이 지남에 따라 모델을 조정할 수 있습니다. 지원되는 모델에는 Claude, GPT, Gemini가 있습니다. 권장 기본값은 '자동'입니다.
Notion 크레딧 대시보드에서 사용량을 트래킹하는 방법을 알아보세요.
모델을 선택하려면 다음 단계를 따르세요.
에이전트의
설정을 여세요.모델섹션으로 이동하세요.일관된 동작을 원하면 특정 모델을 선택하고, 요청마다 Notion이 최적의 모델을 선택하도록 하려면 '자동'을 선택하세요.
저장하세요.
커스텀 에이전트는 워크스페이스에서 다른 사람과 공유할 때 Notion 페이지와 비슷하게 작동하지만 몇 가지 차이점이 있습니다.
팀과 에이전트 공유하기
에이전트를 공유하면 에이전트가 에이전트 섹션의 사이드바, 검색 결과와 더불어, 에이전트를 나열하거나 참조하는 모든 워크스페이스에 표시될 수 있습니다.
에이전트를 공유하려면 다음 단계를 따르세요.
커스텀 에이전트를 엽니다.
공유를 클릭하세요.사람, 그룹 또는 전체 워크스페이스를 추가하세요.
권한 레벨
에이전트는 단순화된 권한 수준 집합을 사용합니다.
모두 허용에이전트에 대한모두 허용권한이 있는 사용자는 지침, 트리거, 사용 권한 및 모델을 구성하고, 활동 로그를 보고 관리하고, 에이전트를 실행하거나 상호 작용할 수 있습니다.편집 허용에이전트에 대한편집 허용권한이 있는 사용자는 지침 및 구성을 수정하고 활동을 검토할 수 있습니다.읽기 및 상호 작용 허용에이전트에 대한읽기 및 상호 작용 허용권한이 있는 사용자는에이전트를 실행하고 채팅하고 읽기 전용 모드에서 설정 페이지(트리거, 지침, 도구 및 사용 권한)를 볼 수 있습니다. 에이전트를 편집하거나 공유할 수는 없습니다.

사용 권한이 없는 사용자는 여전히 접근 가능한 채널에서 Slack 메시지와 같은 이벤트에 응답하도록 구성된 에이전트를 트리거하거나 해당 에이전트와 상호 작용할 수 있습니다.
커스텀 에이전트가 구축되면 사이드바에 표시됩니다. 모든 커스텀 에이전트 페이지에는 세 가지 핵심 탭이 있습니다. 이 탭들을 함께 사용해 에이전트를 설계하고, 테스트하며, 시간에 지남에 따라 유지관리하세요.
채팅특정 에이전트를 위한 비공개 또는 공유 1:1 대화 영역입니다.새로운 지침을 테스트하고, 에이전트에게 일회성 작업을 실행하도록 요청하고, 동작을 반복하는 데 유용합니다.
활동모든 에이전트의 실행 로그로,모두 허용권한이 있는 사용자에게 표시됩니다.로그에는 실행이 트리거된 작업, 수행된 작업 및 오류 또는 실패가 포함됩니다.
설정에이전트의 제어 센터입니다.설정 패널에는 에이전트
지침,트리거, 접근 권한 및 모델 선택이 포함됩니다.

구성을 대화로 처리합니다. 커스텀 에이전트 채팅 기능을 사용하여 에이전트 지침을 테스트하고, 디버깅하고, 이를 반복합니다. 에이전트에게 1회성 작업을 실행하고, 오류에 대한 컨텍스트를 제공하고, 다양한 시나리오를 테스트하도록 요청합니다.
설정 탭을 사용하여 에이전트 편집하기
에이전트페이지를 여세요.설정탭으로 이동하세요.지침,트리거, 페이지, 데이터베이스 및 외부 도구에 대한 사용 권한 또는 모델 선택을 업데이트하세요.변경 사항을 저장하고 게시하세요.
채팅탭과활동탭을 사용하여, 편집 후 에이전트가 예상대로 작동하는지 확인하세요.
버전 기록으로 변경 사항 실행 취소하기
이전 버전의 커스텀 에이전트를 복원하려면 다음 단계를 따르세요.
에이전트페이지를 여세요.버전 기록에 접근하세요.이전 버전을 검토하여 다음을 확인하세요.
변경한 사람.
변경 시점.
각 버전에서 변경된 사항.
복원하려는 버전을 선택하세요.
에이전트를 해당 버전으로 되돌릴지 확인하세요.
자주 묻는 질문(FAQ)
오른쪽 하단 모서리에 있는 Notion 에이전트와의 차이점은 무엇인가요?
오른쪽 하단 모서리에 있는 Notion 에이전트와의 차이점은 무엇인가요?
Notion 에이전트를 통해 다음을 수행할 수 있습니다.
콘텐츠 초안을 작성하고, 편집하고, 요약합니다.
페이지와 데이터베이스에 관한 질문에 답합니다.
사용자가 일하는 동안 1회성 작업을 수행합니다.
커스텀 에이전트:
사용자가 정의한 정확한 에이전트 지침을 따릅니다.
트리거와 일정 잡기를 통해 백그라운드에서 자율적으로 실행할 수 있습니다.
명시적으로 부여한 페이지, 데이터베이스, 외부 도구에서만 작동합니다.
Notion 에이전트는 온디맨드로 작동하는 반면, 커스텀 에이전트는 자율적으로 실행됩니다.
실행이 실패할 경우 어떻게 직접 디버깅할 수 있나요?
실행이 실패할 경우 어떻게 직접 디버깅할 수 있나요?
실행을 디버깅하려면 다음과 같이 합니다.
에이전트 페이지를 여세요.
에이전트의
활동탭으로 이동합니다. 이 탭은 에이전트의설정이나 에이전트 채팅 보기에 있습니다.리스트에서 실패한 실행을 찾습니다.
열어서 다음 사항을 확인합니다.
실행을 트리거한 요소
각 단계에서 에이전트가 '생각'하고 수행한 작업
모든 오류 메시지 또는 설명
에이전트가 잘못된 행동을 한 경우:
에이전트 지침이나 트리거를 조정합니다.
업데이트된 구성으로 다시 실행합니다.
문제가 있거나 의심스러운 점이 있는 경우, 담당팀에서 시스템을 개선할 수 있도록 '도움이 되지 않아요'를 누르고 가능한 경우 자세한 설명을 제공해 주세요.
연동하려면 어떤 Slack 앱이 필요한가요?
연동하려면 어떤 Slack 앱이 필요한가요?
커스텀 에이전트에서 Slack을 사용하려면 다음과 같이 합니다.
Notion에서 사용하는 이메일 주소와 동일한 이메일 주소로 Slack이 연동되어 있는지 확인합니다.
에이전트 설정 중에 메시지가 표시되면 Notion의 다른 곳에서 Slack을 이미 사용하고 있더라도 Slack 앱을 연동시킵니다.
접근을 승인하고 에이전트가 읽거나 쓸 수 있는 채널을 구성합니다.
누가 커스텀 에이전트를 생성하고 볼 수 있나요?
누가 커스텀 에이전트를 생성하고 볼 수 있나요?
기본적으로 커스텀 에이전트는 워크스페이스의 모든 사용자가 사용할 수 있습니다.
엔터프라이즈 요금제 관리자는
설정>Notion AI>에이전트>에이전트를 생성할 수 있는 사용자 제어로 이동하여 사용 권한을 제한할 수 있습니다.
각 에이전트의 경우:
생성자는 접근할 수 있는 사용자와 접근 수준(
모두 허용,편집 허용,상호 작용 가능)을 결정합니다.Slack에서는 채널의 모든 사용자가 해당 채널의 에이전트가 게시한 메시지를 볼 수 있습니다.
이 에이전트가 실행될 위치를 어떻게 알 수 있나요?
이 에이전트가 실행될 위치를 어떻게 알 수 있나요?
에이전트를 구성하는 동안 다음 사항을 확인합니다.
확인할 수 있는 트리거:
활성화되어 있는 주기
감시되고 있는 Notion 데이터베이스 또는 페이지
연동되어 있는 Slack 채널 또는 기타 앱
확인할 수 있는 접근/권한:
에이전트가 사용할 수 있는 페이지, 데이터베이스, 외부 출처
확인할 수 있는 활동:
에이전트가 이미 실행된 위치와 수행한 작업
게시 후:
활동 탭과 로그를 사용하여 에이전트가 예상되는 곳에서만 실행되고 있는지 확인합니다.
워크플로에 맞게 행동이 유지되도록 정기적으로 실행을 검토합니다.
