Operator Connect
Com o Operator Connect, você escreve o briefing na ferramenta de IA que já usa — Claude, Cursor ou outro cliente MCP — e o BrazeAI OperatorTM constrói tudo no seu dashboard da Braze.
O Operator Connect está atualmente em beta e disponível para clientes selecionados. Entre em contato com seu gerente de sucesso do cliente para solicitar acesso.
Antes de começar
O Operator Connect não usa aprovações etapa por etapa
O Operator Connect solicita menos aprovações explícitas do que o BrazeAI Operator no dashboard. Ele ainda respeita as permissões do usuário conectado ao dashboard, então só pode realizar ações que esse usuário tem permissão para realizar no dashboard. Revise essas permissões antes de usar o Operator Connect: o agente tem o mesmo nível de acesso.
O Operator não pode, atualmente, lançar Campaigns ou Canvas.
Para limitar o que o Operator pode alterar, crie um usuário dedicado da Braze com permissões específicas para o Operator Connect. Para ajuda na configuração, consulte Gerenciar usuários da empresa. Isso também facilita a identificação das alterações do Operator no dashboard. Se sua equipe exige aprovação etapa por etapa, use o BrazeAI Operator no dashboard.
Use o Operator Connect para trabalhos agênticos e que exigem julgamento
Use-o para coisas como criar uma Campaign a partir de um briefing, reestruturar um Canvas ou responder uma pergunta complexa sobre seu espaço de trabalho. O Operator Connect não é a ferramenta certa para operações programáticas de alto volume e alta frequência. Para esses fluxos de trabalho, use a REST API da Braze.
Pré-requisitos
Antes de usar o Operator Connect, confirme o seguinte:
| Pré-requisito | Descrição |
|---|---|
| Servidor MCP da Braze hospedado | O Operator Connect é disponibilizado somente através do servidor MCP hospedado da Braze, baseado em OAuth. Clientes no servidor MCP local com chave de API precisam migrar para o servidor remoto hospedado primeiro. Consulte Configurar o servidor MCP da Braze. |
| Operator ativado para seu espaço de trabalho | O BrazeAI Operator precisa estar ativo no seu espaço de trabalho. |
| Permissão Use MCP Server | Seu usuário do dashboard precisa da permissão “Use MCP Server”. |
Remova e adicione novamente o servidor MCP após o acesso ser ativado
Quando a Braze ativa o Operator Connect na sua conta, sua conexão MCP existente não detecta automaticamente o novo escopo. Depois que a Braze confirmar que seu acesso está ativado, remova e adicione novamente o servidor MCP da Braze no seu cliente. Para ajuda, consulte Solução de problemas.
O que você pode fazer com o Operator Connect
O Operator Connect pode realizar as mesmas ações que o BrazeAI Operator no dashboard, incluindo:
- Criar e editar Campaigns e Canvas
- Criar e atualizar Segments
- Redigir textos e modelos de e-mail, SMS, push e mensagens no app
- Gerenciar Content Blocks
- Gerar relatórios e responder perguntas com base nos dados do seu espaço de trabalho
Para a lista completa de funcionalidades, consulte O que você pode fazer com o Operator.
Como o Operator Connect funciona
Escreva seu prompt em linguagem natural. Seu cliente MCP normalmente escolhe o Operator Connect a partir do briefing, sem que você precise nomear o Operator ou suas ferramentas.
Se o cliente ignorar o Operator Connect para uma tarefa que o Operator pode completar, você pode adicionar instruções mais explícitas para usar o Operator Connect.
Quando você envia um prompt, seu cliente o submete ao Operator e recupera o resultado automaticamente. Três ferramentas no servidor MCP hospedado da Braze lidam com isso:
ask_operator— Envia um prompt em linguagem natural e retorna um ID de job. O Operator executa o job de forma assíncrona.get_operator_result— Recupera o resultado de um determinado ID de job.cancel_operator_job— Interrompe um job em execução.
Exemplos de prompts
Comece com um briefing em linguagem natural. Aqui estão alguns exemplos:
Build a three-step welcome Canvas for new loyalty members—email on day 1, push on day 3, and an in-app message on day 7. Save it as a draft in the Production workspace.
Review the Subject Line and Preheader of the 'Summer Sale Email' campaign in the Production workspace and suggest improvements for better open rates.
Create a segment for users who have made a purchase in the last 30 days but haven't opened a push notification in the last 14 days.
What were our top five email campaigns by click rate last quarter? Summarize the key differences between them.
O que esperar
O Operator Connect funciona de forma diferente de uma chamada de API síncrona. Veja o que planejar.
Respostas assíncronas
As respostas levam alguns minutos, não segundos. O Operator Connect executa cada job como uma sessão agêntica completa — aproximadamente o mesmo tempo que levaria para fazer o trabalho equivalente no dashboard. Defina expectativas de acordo, caso você esteja compartilhando resultados do Operator Connect com outras pessoas ou sistemas downstream. Se você está construindo um agente personalizado que chama essas ferramentas diretamente, projete-o para consultar get_operator_result em vez de esperar uma resposta imediata. As respostas são retornadas como texto, sem formato de saída estruturado.
Sem visualização de observabilidade
Não há UI dedicada no dashboard, log de sessão ou visualização de observabilidade para o uso do Operator Connect neste beta. As ações realizadas pelo Operator aparecem no dashboard sob a atribuição normal do usuário do dashboard que está atuando.
Autenticação e permissões
O Operator Connect usa o mesmo login do servidor MCP da Braze — suas credenciais normais da Braze, sem login separado. O Operator Connect vincula o acesso à sua conta de usuário do dashboard, não a uma chave de API compartilhada. Isso significa que:
- O Operator age com as permissões exatas desse usuário no dashboard. Ele não pode realizar ações que o usuário não poderia realizar diretamente.
- O dashboard atribui todas as alterações ao usuário conectado. Para facilitar a auditoria, use uma conta dedicada da Braze para o Operator Connect. Consulte Antes de começar.
- Quando um usuário perde o acesso à Braze, também perde o acesso ao Operator Connect.
Preços
Para o beta, o uso do Operator Connect conta contra o mesmo limite diário de custo do Operator no nível da empresa, assim como o uso no dashboard. Como o uso programático normalmente consome mais do que o uso interativo, os participantes do beta recebem um limite diário temporariamente elevado durante o programa.
- O limite elevado se aplica apenas durante o programa beta e está sujeito a alterações.
- A Braze não pode garantir que você permanecerá dentro do limite. Se atingi-lo, entre em contato com seu gerente de sucesso do cliente.
O Operator Connect deverá ser um recurso pago na disponibilidade geral. A participação no beta é gratuita, mas não reflete a precificação futura.
Privacidade de dados e segurança
O Operator Connect segue o mesmo modelo de privacidade e segurança do BrazeAI OperatorTM, incluindo os mesmos relacionamentos de processador de dados. Para saber mais, consulte Privacidade de dados e segurança do BrazeAI Operator.
Solução de problemas
As ferramentas do Operator não aparecem após o acesso ser ativado
Quando a Braze ativa o Operator Connect na sua conta, sua conexão MCP existente pode não detectar automaticamente as permissões de acesso atualizadas. Se você enviar um prompt e receber um erro de autenticação, ou se as ferramentas do Operator não aparecerem no seu cliente:
- No seu cliente MCP, remova a conexão do servidor MCP da Braze.
- Adicione novamente o servidor MCP da Braze usando a URL do seu endpoint (
https://mcp.braze.com/mcppara US,https://mcp.braze.eu/mcppara EU). - Complete o fluxo de login OAuth novamente.
Após adicionar novamente, seu cliente se registra com as permissões de acesso atualizadas, incluindo o Operator Connect. Se o problema persistir, entre em contato com seu gerente de sucesso do cliente.
Próximas etapas
- Configurar o servidor MCP da Braze (pré-requisito para o Operator Connect)
- BrazeAI Operator
- O que você pode fazer com o Operator