Visão Geral

Permita que seus agentes gerenciem páginas, bancos de dados e conteúdos através do Notion. Crie e atualize páginas, gerencie blocos de conteúdo, organize bases de conhecimento e otimize seus fluxos de documentação com automação alimentada por IA.

Pré-requisitos

Antes de usar a integração com o Notion, certifique-se de que você tem:

Configurando a Integração com o Notion

1. Conecte sua Conta Notion

  1. Acesse Integrações do CrewAI Enterprise
  2. Procure por Notion na seção de Integrações de Autenticação
  3. Clique em Conectar e complete o fluxo de OAuth
  4. Conceda as permissões necessárias para gerenciamento de páginas e bancos de dados
  5. Copie seu Token Enterprise em Configurações da Conta

2. Instale o Pacote Necessário

uv add crewai-tools

Ações Disponíveis

Exemplos de Uso

Configuração Básica do Agente Notion

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

# Get enterprise tools (Notion tools will be included)
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

# Create an agent with Notion capabilities
notion_agent = Agent(
    role="Documentation Manager",
    goal="Manage documentation and knowledge base in Notion efficiently",
    backstory="An AI assistant specialized in content management and documentation.",
    tools=[enterprise_tools]
)

# Task to create a meeting notes page
create_notes_task = Task(
    description="Create a new meeting notes page in the team database with today's date and agenda items",
    agent=notion_agent,
    expected_output="Meeting notes page created successfully with structured content"
)

# Run the task
crew = Crew(
    agents=[notion_agent],
    tasks=[create_notes_task]
)

crew.kickoff()

Filtrando Ferramentas Específicas do Notion

from crewai_tools import CrewaiEnterpriseTools

# Get only specific Notion tools
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token",
    actions_list=["notion_create_page", "notion_update_block", "notion_search_pages"]
)

content_manager = Agent(
    role="Content Manager",
    goal="Create and manage content pages efficiently",
    backstory="An AI assistant that focuses on content creation and management.",
    tools=enterprise_tools
)

# Task to manage content workflow
content_workflow = Task(
    description="Create a new project documentation page and add structured content blocks for requirements and specifications",
    agent=content_manager,
    expected_output="Project documentation created with organized content sections"
)

crew = Crew(
    agents=[content_manager],
    tasks=[content_workflow]
)

crew.kickoff()

Gerenciamento de Base de Conhecimento

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

knowledge_curator = Agent(
    role="Knowledge Curator",
    goal="Curate and organize knowledge base content in Notion",
    backstory="An experienced knowledge manager who organizes and maintains comprehensive documentation.",
    tools=[enterprise_tools]
)

# Task to curate knowledge base
curation_task = Task(
    description="""
    1. Search for existing documentation pages related to our new product feature
    2. Create a comprehensive feature documentation page with proper structure
    3. Add code examples, images, and links to related resources
    4. Update existing pages with cross-references to the new documentation
    """,
    agent=knowledge_curator,
    expected_output="Feature documentation created and integrated with existing knowledge base"
)

crew = Crew(
    agents=[knowledge_curator],
    tasks=[curation_task]
)

crew.kickoff()

Estrutura e Organização de Conteúdo

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

content_organizer = Agent(
    role="Content Organizer",
    goal="Organize and structure content blocks for optimal readability",
    backstory="An AI assistant that specializes in content structure and user experience.",
    tools=[enterprise_tools]
)

# Task to organize content structure
organization_task = Task(
    description="""
    1. Get content from existing project pages
    2. Analyze the structure and identify improvement opportunities
    3. Update content blocks to use proper headings, tables, and formatting
    4. Add table of contents and improve navigation between related pages
    5. Create templates for future documentation consistency
    """,
    agent=content_organizer,
    expected_output="Content reorganized with improved structure and navigation"
)

crew = Crew(
    agents=[content_organizer],
    tasks=[organization_task]
)

crew.kickoff()

Fluxos de Trabalho de Documentação Automatizados

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

doc_automator = Agent(
    role="Documentation Automator",
    goal="Automate documentation workflows and maintenance",
    backstory="An AI assistant that automates repetitive documentation tasks.",
    tools=[enterprise_tools]
)

# Complex documentation automation task
automation_task = Task(
    description="""
    1. Search for pages that haven't been updated in the last 30 days
    2. Review and update outdated content blocks
    3. Create weekly team update pages with consistent formatting
    4. Add status indicators and progress tracking to project pages
    5. Generate monthly documentation health reports
    6. Archive completed project pages and organize them in archive sections
    """,
    agent=doc_automator,
    expected_output="Documentation automated with updated content, weekly reports, and organized archives"
)

crew = Crew(
    agents=[doc_automator],
    tasks=[automation_task]
)

crew.kickoff()

Solução de Problemas

Problemas Comuns

Erros de Permissão

  • Certifique-se de que sua conta Notion possui acesso de edição ao workspace desejado
  • Verifique se a conexão OAuth inclui os escopos necessários para a API do Notion
  • Confira se as páginas e bancos de dados estão compartilhados com a integração autenticada

IDs de Página e Bloco Inválidos

  • Revise os IDs de página e bloco para garantir que estejam no formato UUID correto
  • Garanta que as páginas e blocos referenciados existem e são acessíveis
  • Verifique se os IDs da página ou banco de dados pai são válidos ao criar novas páginas

Problemas com Schema de Propriedades

  • Assegure que as propriedades da página correspondem ao schema do banco de dados ao criar páginas em bancos de dados
  • Verifique se os nomes e tipos das propriedades estão corretos para o banco de dados alvo
  • Confirme que as propriedades obrigatórias estão incluídas ao criar ou atualizar páginas

Estrutura dos Blocos de Conteúdo

  • Assegure que o conteúdo dos blocos segue as especificações de rich text do Notion
  • Verifique se estruturas aninhadas de blocos estão devidamente formatadas
  • Confira se URLs de mídias são acessíveis e estão corretamente formatadas

Problemas de Pesquisa e Filtros

  • Certifique-se de que as queries de pesquisa estão devidamente formatadas e não estão vazias
  • Use nomes de campos válidos em fórmulas de filtro: query, filter.value, direction, page_size
  • Teste pesquisas simples antes de construir condições de filtro mais complexas

Relacionamentos Pai-Filho

  • Verifique se a página ou banco de dados pai existe antes de criar páginas filhas
  • Assegure que existam permissões apropriadas para o container pai
  • Confirme que os schemas do banco permitem definir as propriedades desejadas

Rich Text e Conteúdo de Mídia

  • Assegure que URLs para imagens externas, PDFs e bookmarks sejam acessíveis
  • Verifique se a formatação rich text segue as especificações da API do Notion
  • Confira se os tipos de linguagem nos blocos de código são suportados pelo Notion

Operações de Arquivamento e Exclusão

  • Entenda a diferença entre arquivar (reversível) e excluir (permanente)
  • Certifique-se de ter permissões para arquivar ou excluir o conteúdo desejado
  • Tenha cuidado com operações em massa que possam afetar múltiplas páginas ou blocos

Obtendo Ajuda

Precisa de ajuda?

Entre em contato com nosso time de suporte para auxílio na configuração ou solução de problemas com a integração Notion.