개요
에이전트가 Notion을 통해 페이지, 데이터베이스, 콘텐츠를 관리할 수 있도록 지원합니다. 페이지 생성 및 업데이트, 콘텐츠 블록 관리, 지식 베이스 구성, AI 기반 자동화를 통해 문서화 작업 흐름을 효율화할 수 있습니다.필수 조건
Notion 통합을 사용하기 전에 다음을 확인하세요:- 활성 구독이 있는 CrewAI Enterprise 계정
- 적절한 워크스페이스 권한이 있는 Notion 계정
- 통합 페이지를 통해 Notion 계정을 연결함
Notion 연동 설정
1. Notion 계정 연결하기
- CrewAI Enterprise Integrations로 이동합니다.
- 인증 통합(Auhtentication Integrations) 섹션에서 Notion을(를) 찾습니다.
- Connect를 클릭하고 OAuth 플로우를 완료합니다.
- 페이지 및 데이터베이스 관리를 위한 필요한 권한을 부여합니다.
- Account Settings에서 Enterprise Token을 복사합니다.
2. 필수 패키지 설치
사용 가능한 액션
NOTION_CREATE_PAGE
NOTION_CREATE_PAGE
설명: Notion에서 페이지를 생성합니다.파라미터:
parent
(object, 필수): 상위 - 새 페이지가 삽입될 상위 페이지 또는 데이터베이스를 나타내는 JSON 객체로, page_id 또는 database_id 키를 포함합니다.properties
(object, 필수): 속성 - 페이지 속성의 값입니다. 상위가 데이터베이스인 경우, 스키마는 상위 데이터베이스의 속성과 일치해야 합니다.icon
(object, 필수): 아이콘 - 페이지 아이콘입니다.children
(object, 선택): 자식 - 페이지에 추가할 콘텐츠 블록입니다.cover
(object, 선택): 표지 - 페이지 표지 이미지입니다.
NOTION_UPDATE_PAGE
NOTION_UPDATE_PAGE
설명: Notion에서 페이지를 업데이트합니다.파라미터:
pageId
(string, 필수): 페이지 ID - 업데이트할 페이지의 ID를 지정합니다. (예: “59833787-2cf9-4fdf-8782-e53db20768a5”).icon
(object, 필수): 아이콘 - 페이지 아이콘입니다.archived
(boolean, 선택): 보관됨 - 페이지가 보관(삭제)되었는지 여부입니다. true로 설정하면 페이지를 보관합니다. false로 설정하면 보관 해제(복원)합니다.properties
(object, 선택): 속성 - 페이지에서 업데이트할 속성 값입니다.cover
(object, 선택): 표지 - 페이지 표지 이미지입니다.
NOTION_GET_PAGE_BY_ID
NOTION_GET_PAGE_BY_ID
설명: Notion에서 ID로 페이지를 가져옵니다.파라미터:
pageId
(string, 필수): 페이지 ID - 가져올 페이지의 ID를 지정합니다. (예: “59833787-2cf9-4fdf-8782-e53db20768a5”).
NOTION_ARCHIVE_PAGE
NOTION_ARCHIVE_PAGE
설명: Notion에서 페이지를 보관합니다.파라미터:
pageId
(string, 필수): 페이지 ID - 보관할 페이지의 ID를 지정합니다. (예: “59833787-2cf9-4fdf-8782-e53db20768a5”).
NOTION_SEARCH_PAGES
NOTION_SEARCH_PAGES
설명: 필터를 사용하여 Notion에서 페이지를 검색합니다.파라미터:
searchByTitleFilterSearch
(object, 선택): 불리언 정규형(OR 조건 그룹의 AND 그룹) 형태의 필터입니다.사용 가능한 필드:query
,filter.value
,direction
,page_size
NOTION_GET_PAGE_CONTENT
NOTION_GET_PAGE_CONTENT
설명: Notion에서 페이지 콘텐츠(블록)를 가져옵니다.파라미터:
blockId
(string, 필수): 페이지 ID - 해당 블록이나 페이지의 모든 자식 블록을 순서대로 가져오기 위해 Block 또는 Page ID를 지정합니다. (예: “59833787-2cf9-4fdf-8782-e53db20768a5”).
NOTION_UPDATE_BLOCK
NOTION_UPDATE_BLOCK
설명: Notion에서 블록을 업데이트합니다.파라미터:
blockId
(string, 필수): 블록 ID - 업데이트할 블록의 ID를 지정합니다. (예: “9bc30ad4-9373-46a5-84ab-0a7845ee52e6”).archived
(boolean, 선택): 보관됨 - true로 설정하면 블록을 보관(삭제)합니다. false로 설정하면 보관 해제(복원)합니다.paragraph
(object, 선택): 단락 콘텐츠.image
(object, 선택): 이미지 블록.bookmark
(object, 선택): 북마크 블록.code
(object, 선택): 코드 블록.pdf
(object, 선택): PDF 블록.table
(object, 선택): 테이블 블록.tableOfContent
(object, 선택): 목차 블록.additionalFields
(object, 선택): 추가 블록 유형.
NOTION_GET_BLOCK_BY_ID
NOTION_GET_BLOCK_BY_ID
설명: Notion에서 ID로 블록을 가져옵니다.파라미터:
blockId
(string, 필수): 블록 ID - 가져올 블록의 ID를 지정합니다. (예: “9bc30ad4-9373-46a5-84ab-0a7845ee52e6”).
NOTION_DELETE_BLOCK
NOTION_DELETE_BLOCK
설명: Notion에서 블록을 삭제합니다.파라미터:
blockId
(string, 필수): 블록 ID - 삭제할 블록의 ID를 지정합니다. (예: “9bc30ad4-9373-46a5-84ab-0a7845ee52e6”).
사용 예시
기본 Notion Agent 설정
특정 Notion 도구 필터링
지식 베이스 관리
콘텐츠 구조 및 구성
자동화된 문서화 워크플로우
문제 해결
일반적인 문제
권한 오류- Notion 계정이 대상 워크스페이스에 대한 편집 권한이 있는지 확인하세요
- OAuth 연결에 Notion API에 필요한 범위가 포함되어 있는지 확인하세요
- 페이지와 데이터베이스가 인증된 통합에 공유되어 있는지 확인하세요
- 페이지 ID 및 블록 ID가 올바른 UUID 형식인지 다시 확인하세요
- 참조되는 페이지와 블록이 존재하고 접근 가능한지 확인하세요
- 새 페이지를 생성할 때 상위 페이지 또는 데이터베이스 ID가 유효한지 검증하세요
- 데이터베이스에 페이지를 생성할 때 페이지 속성이 데이터베이스 스키마와 일치하는지 확인하세요
- 대상 데이터베이스에 대해 속성 이름과 타입이 올바른지 확인하세요
- 페이지를 생성하거나 업데이트할 때 필수 속성이 포함되어 있는지 확인하세요
- 블록 콘텐츠가 Notion의 리치 텍스트 형식 사양을 따르는지 확인하세요
- 중첩된 블록 구조가 올바르게 포맷되어 있는지 확인하세요
- 미디어 URL이 접근 가능하며 올바른 형식인지 확인하세요
- 검색 쿼리가 올바르게 포맷되어 있고 비어 있지 않은지 확인하세요
- 필터 공식에서 유효한 필드명을 사용하세요:
query
,filter.value
,direction
,page_size
- 복잡한 필터 조건을 만들기 전에 간단한 검색을 테스트하세요
- 하위 페이지를 생성하기 전에 상위 페이지 또는 데이터베이스가 존재하는지 확인하세요
- 상위 컨테이너에 대한 적절한 권한이 있는지 확인하세요
- 데이터베이스 스키마가 설정하려는 속성을 허용하는지 확인하세요
- 외부 이미지, PDF, 북마크의 URL이 접근 가능한지 확인하세요
- 리치 텍스트 포매팅이 Notion의 API 사양을 따르는지 확인하세요
- 코드 블록의 언어 타입이 Notion에서 지원되는지 확인하세요
- 아카이브(복구 가능)와 삭제(영구적)의 차이를 이해하세요
- 대상 콘텐츠를 아카이브 또는 삭제할 수 있는 권한이 있는지 확인하세요
- 여러 페이지 또는 블록에 영향을 줄 수 있는 대량 작업은 신중히 진행하세요
도움 받기
도움이 필요하신가요?
Notion 연동 설정 또는 문제 해결에 대해 지원팀에 문의해 주세요.