Worker를 사용하여 커스텀 코드 실행하기(베타)

Notion Workers는 개발자 플랫폼의 일부입니다. Notion 인프라에서 커스텀 코드를 실행하여 다음 기능을 지원합니다:

• 데이터베이스 동기화

• 커스텀 에이전트 도구

• 웹훅 트리거

• Worker는 비즈니스 및 엔터프라이즈 요금제에서 사용할 수 있습니다.

• 기본적으로 Workers는 워크스페이스에 대해 켜져 있습니다(소유자만 해당).

• 워크스페이스 소유자는 다음을 수행할 수 있습니다:

  • Workers 생성을 워크스페이스 소유자만 할 수 있도록 제한합니다.

  • 특정 멤버나 그룹이 Workers를 만들 수 있도록 허용합니다.

  • 워크스페이스의 Workers 기능을 끕니다.

• Workers를 배포하거나 관리하려는 경우, 일반적으로 개발자 문서를 따르고 Notion CLI를 사용합니다.

• 개발자 모드를 켜서 Notion에서 Workers를 보고, 로그를 읽고, Workers를 끄거나 삭제할 수 있습니다. Workers를 배포하거나 코드 또는 설정을 변경하려면 Notion CLI 또는 팀의 코딩 도구를 사용하세요. 개발자 모드에 대해 자세히 알아보기 →

Worker 가격에 관해 자세히 알아보려면 이 문서를 참고하세요.

데이터베이스 동기화(Workers 기반)는 외부 도구의 정보를 Notion 데이터베이스로 가져와 자동으로 최신 상태로 유지합니다. 설정이 완료되면 동기화된 데이터베이스가 스스로 최신 상태를 유지하므로, 팀원과 에이전트는 도구 간에 복사하거나 붙여넣을 필요 없이 항상 최신 데이터를 확인할 수 있습니다.

몇 가지 일반적인 예시:

• Zendesk 지원 티켓을 분류 데이터베이스로 동기화

• Salesforce 계정을 파이프라인 트래커로 동기화

• 내부 도구나 데이터베이스의 데이터 동기화

라이브 상태가 되면 동기화된 데이터베이스는 Notion의 다른 데이터베이스와 동일하게 작동합니다. 사용 권한은 표준 Notion 공유 권한에 따라 관리됩니다.

에이전트 도구(Worker 기반)는 Notion이 제공하는 기본 작업과 MCP를 넘어 커스텀 에이전트의 기능을 확장하며, 팀의 업무 방식에 맞게 설계됩니다.

몇 가지 일반적인 예시:

• 데이터 웨어하우스 쿼리 진행

• Notion 문서를 통해 자산 생성

• 기본적으로 지원되지 않거나 MCP를 통해 사용할 수 없는 다른 앱에서 작업 수행

웹훅 트리거(Worker 기반)를 사용하면 다른 도구의 이벤트가 Notion 또는 연결된 다른 시스템에서 워크플로를 시작할 수 있습니다.

몇 가지 일반적인 예시:

• 풀 리퀘스트가 병합될 때 작업 종료

• 구독 상태가 변경될 때 CRM 기록 업데이트

• 제안서 서명이 완료되면 온보딩 문서 생성

설정이 완료되면 이벤트가 발생할 때마다 워크플로가 자동으로 실행되므로 여러 도구에 흩어져 있는 정보를 수동으로 이동시킬 필요가 없습니다.

개발자 모드를 사용하면 사이드바의 개발자 섹션에서 Workers를 열 수 있습니다. 이 보기에서 빠른 확인 및 기본 작업을 수행하세요. Notion에서 다음을 수행할 수 있습니다:

• 모든 Workers를 하나의 리스트에서 확인합니다.

• Worker를 열어 개요, 로그, 환경 변수 및 설정을 확인합니다.

• Worker 로그를 읽습니다.

• Worker를 끄거나 삭제합니다.

Workers를 배포하거나 코드 또는 설정을 변경하려면 Notion CLI 또는 팀의 코딩 도구를 사용하세요.

기본적으로 Workers를 만든 사람만 Workers를 수정하고 새 연결로 추가할 수 있습니다. 팀원들이 Workers를 커스텀 에이전트에 연결하거나 관리할 수 있도록 Workers를 공유하세요.

Workers 공유 방법에 대해 자세히 알아보기 →

다음 단계를 순서대로 시도해 보세요.

1. 워크스페이스가 자격 요건을 충족하는지, 워크스페이스 소유자가 Workers를 켰는지 확인하세요. Workers는 비즈니스 및 엔터프라이즈 요금제에서 사용할 수 있으며, 워크스페이스 관리자가 활성화해야 합니다.

2. 의도한 설정 경로를 사용 중인지 확인하세요. 대부분의 설정에는 Notion CLI와 개발자 문서를 사용합니다.

3. Workers 배포가 실패하면 권한을 확인하세요. 해당 워크스페이스의 페이지를 볼 수 있더라도 배포 권한이 없을 수 있습니다.

4. Workers가 실행되지만 Notion에서 아무것도 변경되지 않는다면, 먼저 작업을 수동으로 테스트하세요. Notion에서 동일한 변경을 수행할 수 없다면, 일반적으로 권한이나 워크스페이스 설정 문제입니다.

5. 비용이 예상보다 높게 보이면 실행 빈도를 낮추세요. 더 자주 실행되는 Workers일수록 비용이 더 많이 듭니다. 더 느린 일정 잡기로 시작한 다음, 작동이 확실해지면 실행 빈도를 높이세요.

6. 아직 해결되지 않으셨나요? 특정 오류 메시지에 대해서는 개발자 문서를 따르세요. 가장 정확한 해결 방법을 확인하실 수 있습니다.