Introdução à Plataforma para Desenvolvedores Notion

Com os Agentes Personalizados, o Notion tornou-se o espaço de trabalho colaborativo com IA, onde equipes e agentes trabalham em parceria pela produtividade. Equipes de todo o mundo já construíram mais de um milhão de Agentes Personalizados até agora, automatizando tudo, desde perguntas e respostas no Slack e geração de relatórios semanais, até o roteamento automatizado de tarefas.

Apesar disso, quanto mais equipes integravam os agentes aos fluxos de trabalho reais, mais se deparavam com os mesmos obstáculos. Um agente incapaz de acessar dados externos, um fluxo de trabalho que requer lógica personalizada ou um agente de programação sem nenhum acesso ao espaço de trabalho. Cada equipe tem seu próprio stack de ferramentas, por isso, quanto mais os agentes de sistemas penetram, mais úteis eles se tornam. Até agora, a resposta honesta Para “será que o Notion pode fazer isso?” nem sempre tinha sido um sim.

Por isso, apresentamos a Plataforma para Desenvolvedores Notion, com novos blocos de construção que permitem aos desenvolvedores e agentes expandirem as possibilidades do Notion, indo muito além.

Com o Notion não é tudo 100% freestyle (bem que a gente gostaria que fosse) Os fluxos de trabalho da sua equipe envolvem ferramentas e sistemas com os quais o Notion não consegue se conectar de forma nativa. Até agora, preencher essas lacunas significava executar plataformas de automação de terceiros ou scripts personalizados na sua própria infraestrutura.

Workers transformam essa realidade. Eles atuam como runtime hospedado no Notion para execução de código personalizado. Escreva o seu registro, implemente em uma sandbox segura e em tempo real com zero servidores de provisionamento, zero configuração de contêineres. Um único Worker pode sincronizar bases de dados, ferramentas, Agentes Personalizados e gatilhos de webhook. Além disso, quando as ferramentas MCP não bastam (quando você precisa de execução previsível e lógica personalizada) os Workers garantem o controle total. O fluxo de implementação é rápido: Autentique através do CLI, programe seu código (ou delegue ao agente de programação) e implemente.

ntn auth

worker.deploy()

Os Workers já estão disponíveis na versão beta pública nos planos Business e Enterprise, gratuitamente até agosto.

As informações da sua equipe estão dispersas por diversas ferramentas: CRM, plataformas de suporte, base de dados de dados de produção e sistemas internos. Essa fragmentação significa que sua equipe e seus agentes estão sempre trabalhando com um contexto fragmentado. Você não pode criar fluxos de trabalho de agente confiáveis baseando-se em dados obsoletos.

A sincronização de bases de dados (alimentada pelos Workers) consolida dados ee qualquer sistema de registro com uma API (Zendesk, Salesforce, Postgres etc.) para base de dados do Notion, mantendo tudo atualizado automaticamente. Programe a lógica de sincronização e implemente o Worker. Seus dados externos residem no Notion, junto com tudo o que sua equipe já usa. Agora, seus agentes podem ler e ver tudo, e todos trabalham com acesso ao mesmo, compartilhado e confiável.

Agentes Personalizados incluem ferramentas integradas e podem se conectar a recursos de terceiros via MCP. O MCP é ótimo para garantir a ampla conectividade, mas alguns fluxos de trabalho exigem execução previsível e lógica personalizada que as ferramentas mediadas por LLM nem sempre conseguem fornecer.

Agora, você pode criar ferramentas de agentes com os Workers. Eles funcionam de maneira deterministas e com economia de token: seu código é sempre executado exatamente como foi projetado. Programa a lógica de ferramenta personalizada, implemente-a como um Worker e o seu Agente Personalizado pode acioná-la imediatamente. Seja extraindo dados de clientes do CRM, acionando um sistema interno ou executando uma validação específica para o fluxo de trabalho da sua equipe, você tem a liberdade de construir exatamente o que precisa.

As equipes usam diversos agentes e ferramentas de IA. Mas a maioria desses agentes não pode atuar no Notion, e não há outro lugar onde todos os seus agentes possam trabalhar juntos. Você acaba se perdendo em chats de apps diferentes, copiando e colando contexto entre ferramentas e com a impressão de que você é quem segura todas as pontas. Mas, a ideia não era justamente liberar você do trabalho de formiguinha?

Os agentes externos são o primeiro passo para que a Notion se torne o espaço de trabalho onde cada agente usado pela sua equipe pode operar nativamente, ao lado dos Agentes Personalizados e da sua equipe. Interaja com os agentes externos diretamente no chat no Notion, atribua tarefas e acompanhe o progresso, como você já faz com os Agentes Personalizados.

Claude Code, Cursor, Codex e Decagon são apenas alguns dos agentes parceiros disponíveis prontos para usar, com mais soluções sendo adicionadas em breve.

A API de agentes externos possibilita isso para seus próprios agentes também. Se sua equipe tiver construído agentes internos em outros frameworks (um agente interno de suporte, um agente de operações especialmente projetado, ou algo específico para a sua empresa) a API de agentes externos permite levá-los ao Notion como colaboradores vip do espaço de trabalho.

Entre para a lista de espera para obter acesso a versão beta privada.

O CLI (ntn) é a solução para que desenvolvedores e agentes de programação interajam com toda a plataforma dev. Autentique uma vez, leia e trabalhe no Notion, gerencie e implemente Workers e automatize fluxos de trabalho, tudo direto do seu terminal ou IDE. Uma só interface para humanos e agentes.

Este é o caminho mais rápido para garantir o acesso total ao Notion para qualquer agente de programação. Basta uma linha no seu terminal e tudo está conectado.

O CLI está agora disponível em todos os planos. A implementação e gerenciamento de Workers está disponível nos planos Business e Enterprise.

Ferramentas para criar agentes estão se desenvolvendo muito mais rápido do que as que estão disponíveis para gerenciá-los. Criamos a Plataforma Dev com isso em mente: autenticação, autorizações e sandboxing fazem parte da plataforma desde a primeira implementação.

• Confiança progressiva. Comece com a revisão humana de cada ação dos agentes e depois expanda a autonomia, conforme os agentes se mostram confiáveis. Você decide o ritmo.

• Visibilidade. O trabalho de cada agente (Agentes Personalizados, de programação e externos) aparece no mesmo espaço de trabalho onde sua equipe colabora. Quem executa, aprova e o que foi feito.

• Tudo na sandbox

  

  TL;DR

  • Notion’s Developer Platform is here. New features that give developers and agents the capabilities to build on Notion—extend Custom Agents, bring any data source into your workspace, and work with every agent your team uses.

  • Workers let you deploy custom code to Notion's hosted runtime. Sync data into Notion, build custom tools, and trigger work with webhooks—no external infrastructure required. Available now in public beta.

  • External Agents bring agents into Notion as native workspace participants. They show up in your agent list, chat directly in Notion, and take actions alongside your team. Join the waitlist today.

  • External Agent API lets you bring your own agents into Notion the same way. If your team has built agents on other frameworks, they become first-class workspace participants too.

  • The CLI (ntn) ties it all together. Authenticate in one line, read and write to Notion, manage and deploy Workers—all from your terminal or IDE. Available now on all plans.

  • Governance from day one. Auth, permissions, and sandbox are part of the platform from the first deploy.

  Os Workers são executados na sandbox hospedada pelo Notion, e seu código é executado em um ambiente isolado com autorização definidas.

Os Workers usam o mesmo sistema de crédito dos Agentes Personalizados, e estão disponíveis gratuitamente até agosto. Aproveite para criar e explorar.

No momento, os desenvolvedores estão expandindo os limites do que é possível fazer com agentes. Mas essas capacidades não permanecerão um privilégio dos desenvolvedores por muito tempo. Em breve, os Agentes Personalizados usarão esses mesmos tipos primitivos para você, construindo suas próprias ferramentas, conectando-se a outros sistemas e expandindo possibilidades sem você encostar em um terminal.

Estamos desenvolvendo isso de maneira acelerada e transparente, e ficamos na expectativa de ver o que você será capaz de criar. Se você quiser entrar nessa com a gente, [leia a documentação] e [instale o CLI] hoje mesmo.