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

Notion Workers는 개발자 플랫폼의 일부입니다. Workers는 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. 여전히 문제가 해결되지 않았나요? 특정 오류 메시지에 대해서는 개발자 문서를 참고하세요. 가장 정확한 해결 방법을 확인할 수 있습니다.

Workers와 커스텀 에이전트의 차이점은 무엇인가요?

Workers와 커스텀 에이전트는 서로 다른 문제를 해결하지만, 함께 작동할 수 있습니다.

• Workers: Notion의 인프라에서 커스텀 코드를 실행합니다. 개발자는 자동화, 주기에 따른 동기화, 사용자 지정 API 통합 등의 작업에 Workers를 사용합니다.

• 커스텀 에이전트: 팀의 반복적인 업무를 자동으로 처리합니다. 사용자가 트리거를 설정하면 워크스페이스를 맥락으로 하여 백그라운드에서 실행됩니다.

일부 설정에서는 Worker를 통해 커스텀 에이전트에서 사용할 수 있는 고유한 도구를 구동할 수 있습니다. 예를 들어 Worker가 다른 시스템에서 데이터를 가져오면 에이전트는 해당 데이터를 이용하여 응답하거나 작업을 수행할 수 있습니다.

Worker는 자동화와 동일한 기능인가요?

꼭 그렇지는 않습니다. 자동화는 Notion에 내장되어 있으며 누구나 설정할 수 있도록 설계되었습니다. Worker는 커스텀 코드를 실행하고자 하는 개발자를 위한 기능입니다. 코드가 필요하지 않다면 자동화부터 시작하세요.