Entenda os preços dos workers (beta)

Os workers executam código em segundo plano para automatizar tarefas no Notion. Eles são ideais para tarefas que não exigem raciocínio de IA, como sincronizar dados, gravar atualizações e gerenciar eventos. Os workers são em geral combinados com Agentes Personalizados: o agente decide o que fazer e os workers executam etapas específicas de forma confiável.

Durante a fase beta, os workers podem ser testados gratuitamente nos Planos Business e Enterprise (incluindo o período de teste do Plano Business). A partir de 11 de agosto de 2026, eles exigirão créditos do Notion. Os administradores de espaço de trabalho podem comprar créditos do Notion como um complemento aos Planos Business e Enterprise.

O período beta gratuito se aplica apenas aos workers. As ações do Agente Personalizado consumirão créditos de acordo com o plano do seu espaço de trabalho e as configurações de créditos.

Os workers usam créditos do Notion, que são calculados com base nas execuções. Cada execução representa uma unidade de trabalho concluída para você. O número de créditos por execução pode variar dependendo do volume de trabalho do worker, como o tempo de execução ou a quantidade de processamento necessária. Em geral, quanto mais trabalho, mais créditos serão usados.

Os workers podem ser executados de algumas maneiras diferentes (e continuaremos expandindo esta lista):

• Sincronizações (agendadas): cada vez que uma sincronização é executada, isso conta como uma execução.

• Chamadas de ferramenta (acionadas por agente): cada vez que um Agente Personalizado aciona uma chamada de ferramenta do worker, isso conta como uma execução.

• Webhooks (event-driven): cada evento que um worker processa conta como uma execução.

Os workers normalmente custam US$ 0,0003 por execução, o que equivale a 33.333 execuções por 1.000 créditos mensais do Notion (US$ 10). Eles são mais baratos em comparação com os Agentes Personalizados porque o preço é baseado no volume de trabalho que eles fazem quando são executados e eles não exigem tomadas de decisão de IA.

As tabelas abaixo detalham os benchmarks de custo para cada tipo de ação do worker. Use-a como base para entender os custos. Seu uso real pode variar, e essa é a melhor maneira de dimensionar os créditos.

A tabela abaixo mostra exemplos de uso. Seu uso real depende da frequência de execução das sincronizações e de quanto trabalho um worker faz em cada execução.

Sincronizar mais dados ou lidar com várias atualizações custará mais. Se você tiver várias sincronizações, vários workers ou até workers que são executados em resposta a muitos eventos, o uso total pode ser maior.

Os workers também podem operar ferramentas personalizadas que os Agentes Personalizados usam. Por exemplo, um Agente Personalizado pode chamar um worker para buscar dados de outro sistema, executar um cálculo ou atualizar registros.

O uso de chamadas de ferramenta depende da frequência com que um agente chama um worker. Cada chamada de ferramenta conta como sua própria execução do worker (portanto, uma execução do agente pode gerar várias execuções do worker).

A tabela abaixo mostra os volumes típicos de webhook e o que eles podem custar. Seu uso real depende de quantos eventos suas ferramentas enviam e de quantos gatilhos de webhook você configurou. Cada evento recebido que você processa conta como uma execução de worker, portanto, o custo total é proporcional ao seu volume de eventos.

Durante a versão beta gratuita, você pode acompanhar o uso de créditos do worker diretamente na CLI, incluindo os últimos sete dias de uso. O consumo do worker também aparecerá no painel de créditos do Notion até o final de maio, para que os administradores possam acompanhar o consumo de créditos dos workers e dos agentes personalizados em um só lugar.

Os workers são gratuitos durante a versão beta, então você pode usar esse tempo para executar fluxos de trabalho reais e calcular quantos créditos serão necessários quando os créditos forem aplicados.

Experimente estas práticas recomendadas para manter a previsibilidade no uso do worker:

• Comece com um cronograma lento. Para sincronizações, comece com execuções horárias ou diárias se as atualizações em tempo real não forem necessárias.

• Aumente a frequência apenas quando necessário. Passe para a cada 15 minutos, 5 minutos ou a cada minuto apenas se o fluxo de trabalho exigir.

• Trabalhe em lotes sempre que possível. Em vez de executar um worker para cada pequena mudança, agrupe as atualizações.

• Sincronize apenas o que você precisa. Sincronize apenas as bases de dados, registros ou campos necessários.

• Evite novas tentativas desnecessárias. Se um worker falhar, não deixe que ele faça novas tentativas com muita frequência sem resolver o problema subjacente.

• Analise o uso regularmente. Verifique o uso da CLI durante a configuração e após grandes mudanças no fluxo de trabalho.