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

Notion Worker는 개발자 플랫폼의 일부입니다. Worker는 Notion의 인프라에서 커스텀 코드를 실행하여 다음을 구동합니다.

• 데이터베이스 동기화

• 커스텀 에이전트 도구

• 웹훅 트리거

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

• 워크스페이스 소유자가 워크스페이스에 대해 Worker를 활성화해야 합니다.

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

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

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

몇 가지 일반적인 예시:

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

• Salesforce 계정을 파이프라인 추적기로 동기화

• 내부 도구 또는 데이터베이스 데이터를 동기화

동기화된 데이터베이스는 게시된 후 Notion의 다른 데이터베이스와 마찬가지로 작동합니다. 사용 권한은 기존 Notion 공유 권한 설정을 따릅니다.

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

몇 가지 일반적인 예시:

• 데이터 웨어하우스 쿼리 중

• Notion 문서에서 자산 생성

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

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

몇 가지 일반적인 예시:

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

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

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

설정이 완료되면 이벤트가 발생할 때마다 워크플로가 자동 실행되므로 수동으로 도구 간 정보를 이동할 필요가 없습니다.

다음을 순서대로 시도해 보세요.

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

2. 의도한 학습 과정을 사용 중인지 확인하세요. 대부분의 설정에서는 Notion CLI 와개발자 문서를 사용하게 됩니다.

3. Worker 배포에 실패할 경우, 다음 단계로 권한을 확인하세요. 해당 워크스페이스 내 페이지를 볼 수 있더라도 배포 권한이 없을 수 있습니다.

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

5. 비용이 예상보다 높을 경우, 실행 빈도를 낮추세요. 더 자주 실행되는 Worker는 비용이 더 많이 듭니다. 먼저 낮은 실행 빈도로 시작한 다음, 정상적으로 작동하는 것이 확인되면 실행 빈도를 높이는 것이 좋습니다.

6. 여전히 문제가 해결되지 않았나요? 특정 오류 메시지에 대해서는 개발자 문서를 참고하세요. 가장 정확한 해결 방법을 확인할 수 있습니다.