Integração com o Notion
Gerenciamento de páginas e bancos de dados com integração do Notion para o CrewAI.
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:
- Uma conta CrewAI Enterprise com assinatura ativa
- Uma conta Notion com permissões adequadas no workspace
- Sua conta Notion conectada através da página de Integrações
Configurando a Integração com o Notion
1. Conecte sua Conta Notion
- Acesse Integrações do CrewAI Enterprise
- Procure por Notion na seção de Integrações de Autenticação
- Clique em Conectar e complete o fluxo de OAuth
- Conceda as permissões necessárias para gerenciamento de páginas e bancos de dados
- Copie seu Token Enterprise em Configurações da Conta
2. Instale o Pacote Necessário
Ações Disponíveis
NOTION_CREATE_PAGE
NOTION_CREATE_PAGE
Descrição: Cria uma página no Notion.
Parâmetros:
parent
(object, obrigatório): Parent - A página ou banco de dados pai onde a nova página será inserida, representado como um objeto JSON com uma chave page_id ou database_id.properties
(object, obrigatório): Properties - Os valores das propriedades da página. Se o pai for um banco de dados, o schema deve corresponder às propriedades do banco de dados.icon
(object, obrigatório): Icon - O ícone da página.children
(object, opcional): Children - Blocos de conteúdo a serem adicionados à página.cover
(object, opcional): Cover - A imagem de capa da página.
NOTION_UPDATE_PAGE
NOTION_UPDATE_PAGE
Descrição: Atualiza uma página no Notion.
Parâmetros:
pageId
(string, obrigatório): Page ID - Especifique o ID da Página a ser atualizada. (exemplo: “59833787-2cf9-4fdf-8782-e53db20768a5”).icon
(object, obrigatório): Icon - O ícone da página.archived
(boolean, opcional): Archived - Indica se a página está arquivada (excluída). Defina como true para arquivar a página. Defina como false para restaurar.properties
(object, opcional): Properties - Os valores das propriedades a serem atualizados na página.cover
(object, opcional): Cover - A imagem de capa da página.
NOTION_GET_PAGE_BY_ID
NOTION_GET_PAGE_BY_ID
Descrição: Busca uma página pelo ID no Notion.
Parâmetros:
pageId
(string, obrigatório): Page ID - Especifique o ID da Página a ser buscada. (exemplo: “59833787-2cf9-4fdf-8782-e53db20768a5”).
NOTION_ARCHIVE_PAGE
NOTION_ARCHIVE_PAGE
Descrição: Arquiva uma página no Notion.
Parâmetros:
pageId
(string, obrigatório): Page ID - Especifique o ID da Página a ser arquivada. (exemplo: “59833787-2cf9-4fdf-8782-e53db20768a5”).
NOTION_SEARCH_PAGES
NOTION_SEARCH_PAGES
Descrição: Pesquisa páginas no Notion utilizando filtros.
Parâmetros:
searchByTitleFilterSearch
(object, opcional): Um filtro na forma normal disjuntiva - OU de grupos E de condições simples.Campos disponíveis:query
,filter.value
,direction
,page_size
NOTION_GET_PAGE_CONTENT
NOTION_GET_PAGE_CONTENT
Descrição: Obtém o conteúdo (blocos) de uma página no Notion.
Parâmetros:
blockId
(string, obrigatório): Page ID - Especifique o ID de um Bloco ou Página para receber todos os seus blocos filhos na ordem correta. (exemplo: “59833787-2cf9-4fdf-8782-e53db20768a5”).
NOTION_UPDATE_BLOCK
NOTION_UPDATE_BLOCK
Descrição: Atualiza um bloco no Notion.
Parâmetros:
blockId
(string, obrigatório): Block ID - Especifique o ID do Bloco a ser atualizado. (exemplo: “9bc30ad4-9373-46a5-84ab-0a7845ee52e6”).archived
(boolean, opcional): Archived - Defina como true para arquivar (excluir) um bloco. Defina como false para restaurar um bloco.paragraph
(object, opcional): Conteúdo do parágrafo.image
(object, opcional): Bloco de imagem.bookmark
(object, opcional): Bloco de bookmark.code
(object, opcional): Bloco de código.pdf
(object, opcional): Bloco de PDF.table
(object, opcional): Bloco de Tabela.tableOfContent
(object, opcional): Bloco de Sumário.additionalFields
(object, opcional): Blocos adicionais.
NOTION_GET_BLOCK_BY_ID
NOTION_GET_BLOCK_BY_ID
Descrição: Busca um bloco pelo ID no Notion.
Parâmetros:
blockId
(string, obrigatório): Block ID - Especifique o ID do Bloco a ser buscado. (exemplo: “9bc30ad4-9373-46a5-84ab-0a7845ee52e6”).
NOTION_DELETE_BLOCK
NOTION_DELETE_BLOCK
Descrição: Exclui um bloco no Notion.
Parâmetros:
blockId
(string, obrigatório): Block ID - Especifique o ID do Bloco a ser excluído. (exemplo: “9bc30ad4-9373-46a5-84ab-0a7845ee52e6”).
Exemplos de Uso
Configuração Básica do Agente Notion
Filtrando Ferramentas Específicas do Notion
Gerenciamento de Base de Conhecimento
Estrutura e Organização de Conteúdo
Fluxos de Trabalho de Documentação Automatizados
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.