ShipSF 워크샵 - Notion 미니 워커 워크숍

Highlights

• 노션 워커는 AI 에이전트가 외부 서비스와 안전하게 상호작용할 수 있도록 커스텀 코드를 실행하는 확장 프리미티브입니다.

• Vercel 샌드박스와 브로커드 자격 증명 시스템을 도입해 샌드박스가 직접 자격 증명에 접근하지 않고 프록시를 통해 안전하게 API를 호출합니다.

• 에이전트가 작성한 도구 코드는 모듈 내보내기를 통해 자동으로 스키마가 추출되며, 별도의 수동 매니페스트 작성 없이 에이전트에 노출됩니다.

• 도구 호출 시마다 새로운 샌드박스 상태가 스냅샷으로부터 생성되어 이전 실행의 영향을 받지 않는 독립적인 환경을 보장합니다.

• 에이전트는 사용 가능한 모든 도구의 이름과 설명만 먼저 확인하므로, 도구가 늘어나도 컨텍스트 윈도우가 비대해지지 않습니다.

Timeline

1. 00:00 - 04:43

   노션 워커의 개념과 보안 아키텍처

   워커는 MCP나 일반적인 스킬과 달리 배포 인프라와 자격 증명 관리를 추상화하여 에이전트가 안정적으로 트리거할 수 있는 프리미티브를 제공합니다. 사용자가 작성하거나 에이전트가 생성한 임의의 코드가 노션 서비스나 다른 사용자에게 영향을 미치지 않도록 격리된 환경이 필수적입니다. Vercel과의 파트너십을 통해 실제 자격 증명을 샌드박스에 직접 노출하지 않고 프록시를 통해 안전하게 API를 호출하는 구조를 완성했습니다.

   • 워커는 노션을 확장하는 커스텀 코드로 에이전트 도구, 데이터 동기화, 결정론적 자동화 기능을 수행합니다.
   • 에이전트가 직접 자격 증명에 접근하지 않도록 Vercel의 브로커드 자격 증명이 네트워크 요청 헤더에 적시에 자격 증명을 주입합니다.
   • 임의 코드 실행에 따른 보안 위협과 암호화폐 채굴 같은 자원 고갈 문제를 방지하기 위해 샌드박스 인프라를 도입했습니다.
2. 04:43 - 08:35

   점심 주문 에이전트 데모 및 동작 방식

   실제 데모에서는 에이전트가 Forkable 플랫폼과 상호작용하여 점심 식사를 자동으로 주문하는 과정을 보여줍니다. 에이전트에게 커스텀 도구 인터페이스가 공개되어 있어 별도의 수동 개입 없이도 정해진 스케줄에 따라 주문을 수행할 수 있습니다. 복잡한 추론 능력이 없는 에이전트라 하더라도 결정론적 코드를 담은 워커 도구를 호출하면 경로 탐색이나 주문 로직을 정확하게 처리할 수 있습니다.

   • 점심 주문 에이전트는 과거 주문 내역과 식당 정보를 바탕으로 스스로 도구를 호출하여 식사를 주문합니다.
   • 에이전트는 웹 검색이나 복잡한 추론 없이 결정론적 코드를 실행하는 워커 도구를 통해 효율적으로 작업을 처리합니다.
   • 주문 로그가 지속적으로 업데이트되면서 에이전트는 사용자의 선호도를 학습하고 스스로 개선합니다.
3. 08:35 - 19:50

   워커 코드 구조와 빌드 및 배포 프로세스

   워커를 구축할 때는 신뢰할 수 없는 사용자 코드를 로컬이 아닌 클라우드 샌드박스 안에서 빌드하여 보안을 유지합니다. 에이전트가 매니페스트를 직접 작성할 필요 없이 코드가 스스로 설명하도록 모듈을 파싱하여 스키마를 추출합니다. 도구가 호출될 때마다 새로운 샌드박스 스냅샷을 불러와 이전 실행 상태가 다음 호출에 영향을 주지 않는 무상태 환경을 유지합니다.

   • 사용자 코드는 도구 이름, 설명, 입력 스키마, 실행 함수를 포함하는 모듈 내보내기 형식으로 작성됩니다.
   • 타입스크립트 코드는 샌드박스 안에서 컴파일되어 tarball 번들로 생성된 후 블롭 스토리지에 업로드됩니다.
   • 샌드박스 노드 바이너리는 모듈 내보내기를 JSON 문자열화하여 표준 출력으로 내보내고, 이를 검증하여 에이전트 도구 스키마로 사용합니다.
4. 19:50 - 28:43

   Q&A 및 컨텍스트 관리와 보안

   질의응답 세션에서는 도구 증가에 따른 컨텍스트 비대화 문제와 시력 보험 청구 같은 실제 기업용 사용 사례를 다룹니다. 에이전트는 전체 스키마를 한 번에 불러오지 않고 이름과 설명 위주로 접근하기 때문에 토큰 낭비를 줄일 수 있습니다. 또한 불안정한 도구 호출이나 API 오류 발생 시 에이전트의 자체 메모리 시스템과 에러 메시지를 통해 스스로 오류를 수정하고 복구할 수 있습니다.

   • 에이전트는 사용 가능한 모든 도구의 이름과 설명 목록만 먼저 확인하므로 도구가 늘어나도 컨텍스트 윈도우가 비대해지지 않습니다.
   • 에이전트 컴퓨터는 워커 도구와 달리 샌드박스를 더 오래 유지하고 파일 상태를 백업하여 연속적인 작업을 지원합니다.
   • 팀원들과 에이전트를 공유할 경우 연결된 워커 도구와 자격 증명이 함께 공유되어 공동 작업이 가능합니다.