Operator Connect
Com o Operator Connect, você pode agir na Braze a partir da ferramenta de IA que já usa — Claude, Cursor ou outro cliente MCP — e o BrazeAI OperatorTM executa 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 oferece cartões de ação para pré-aprovação de cada ação
Quando você envia um prompt pelo seu cliente MCP para executar uma ação, o Operator não pausa e pede que você aprove cada etapa (como o Operator faz quando usado no dashboard da Braze). Isso significa que as ações que você solicitar ao Operator Connect por meio do seu prompt serão implementadas imediatamente, sem a chance de pedir aprovação. Se sua equipe tem requisitos rígidos de controle de mudanças, provisione um usuário do dashboard da Braze com permissões limitadas e autentique-se como esse usuário, ou realize esses fluxos de trabalho pelo BrazeAI Operator no dashboard.
O Operator não pode atualmente lançar Campaigns ou Canvas.
Para obter ajuda na configuração de um usuário do dashboard com permissões limitadas, consulte Gerenciar usuários da empresa. Isso também facilita a identificação das alterações do Operator no dashboard.
Usando um cliente MCP de provedor terceirizado
Ao usar o Operator Connect, a Braze recebe instruções do seu cliente MCP de provedor terceirizado, como Claude, ChatGPT, Copilot, Gemini CLI, Codex ou Cursor, exatamente como o modelo de IA subjacente desse provedor as formula. Quando você digita uma solicitação em linguagem natural, o modelo de IA interpreta sua solicitação e a traduz em um prompt para o Operator quando o modelo escolhe usar a ferramenta send_operator_prompt. A Braze não vê seu prompt original em linguagem natural e não pode verificar se o prompt gerado reflete total ou precisamente sua solicitação pretendida.
Quando o BrazeAI Operator retorna dados ou um resultado, essa resposta é enviada de volta ao seu cliente MCP de provedor terceirizado, que então interpreta, formata e apresenta a informação para você. A Braze não controla como o modelo de IA apresenta, resume ou descreve as informações retornadas.
A Braze não é responsável por instruções geradas por, ou respostas transmitidas por meio de, qualquer cliente MCP de provedor terceirizado. Revise os resumos gerados por IA comparando com os dados de origem no seu dashboard da Braze e analise qualquer ação proposta por IA antes de implementá-la pelo seu cliente MCP de provedor terceirizado.
Use o Operator Connect para trabalhos agênticos que exigem julgamento
Use-o para tarefas como criar uma Campaign a partir de um briefing, reestruturar um Canvas ou responder a 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.
Rastreamento de alterações e histórico de edições
As edições em Campaigns e Canvas feitas pelo Operator Connect aparecem no histórico de edições do dashboard com o seu nome de usuário. A Braze rastreia essas alterações da mesma forma que rastreia edições feitas diretamente no dashboard.
Quando você edita uma Campaign ou um Canvas usando a ferramenta send_operator_prompt, o histórico de edições exibe a alteração na sua conta de usuário do dashboard. Isso se aplica tanto ao BrazeAI Operator no dashboard quanto ao Operator Connect via o servidor MCP da Braze.
Edições feitas usando outras ferramentas do servidor MCP da Braze (como update_campaign_message_variation) não aparecem no histórico de edições de Campaigns. Se você precisa de uma trilha de auditoria completa para todas as alterações em Campaigns, use o Operator Connect em vez de chamar ferramentas individuais de atualização do MCP diretamente.
O histórico de edições do Canvas funciona da mesma forma que o histórico de edições de Campaigns. Para preservar um registro das alterações, use o histórico de versões do Canvas para salvar versões manualmente antes de fazer edições significativas.
Pré-requisitos
Antes de usar o Operator Connect, confirme o seguinte:
| Pré-requisito | Descrição |
|---|---|
| Servidor MCP hospedado da Braze | O Operator Connect é disponibilizado apenas pelo servidor MCP hospedado da Braze, baseado em OAuth. Clientes que utilizam o servidor MCP local com chave de API precisam migrar para o servidor hospedado remoto primeiro. Consulte Configurar o servidor MCP da Braze. |
| Cluster US ou EU | O Operator Connect está disponível apenas nos clusters US e EU durante a fase beta atual. |
| Operator ativado para o seu espaço de trabalho | O BrazeAI Operator precisa estar ativo no seu espaço de trabalho. |
| Permissão Use MCP Server | O usuário do dashboard precisa ter a permissão “Use MCP Server”. |
Reautenticar após a ativação do acesso
Quando a Braze ativa o Operator Connect na sua conta, a conexão MCP existente não detecta automaticamente o novo escopo. Após a Braze confirmar que o acesso foi ativado, remova e adicione novamente o servidor MCP da Braze no seu cliente. Para obter ajuda, consulte Solução de problemas.
O que você pode fazer com o Operator Connect
O Operator Connect pode fazer tudo o que o BrazeAI Operator no dashboard pode fazer, incluindo:
- Criar e editar Campaigns e Canvas
- Criar e atualizar Segments
- Rascunhar 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 ver a lista completa de recursos, consulte O que você pode fazer com o Operator.
Como o Operator Connect funciona
Escreva seu prompt em linguagem natural. Seu cliente MCP geralmente 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 concluir, 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 cuidam disso:
send_operator_prompt— 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.
Por exemplo, você pode pedir à sua ferramenta de IA para criar um Canvas de ativação com base em um briefing. Seu cliente chama o Operator Connect, que busca o espaço de trabalho e o Segment, e então constrói o Canvas na Braze como um rascunho para você revisar e lançar.
Exemplos de prompts
Comece com um briefing em linguagem natural. Veja 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 podem levar alguns minutos, não segundos. O Operator Connect executa cada tarefa como uma sessão agêntica completa — aproximadamente o mesmo tempo que levaria para fazer o trabalho equivalente no dashboard. Defina expectativas adequadas se você estiver compartilhando as saídas do Operator Connect com outras pessoas ou sistemas posteriores. Se você estiver criando 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 memória de sessão entre chamadas
Cada prompt é executado em sua própria sessão isolada. O Operator não carrega contexto de uma chamada para a próxima. Se o seu próximo prompt depende da saída de um anterior, inclua o contexto relevante no novo prompt.
Sem visualização de observabilidade
Não há UI dedicada no dashboard, registro de sessão ou visualização de observabilidade para o uso do Operator Connect nesta versão beta. As ações realizadas pelo Operator aparecem no dashboard sob a atribuição normal do usuário do dashboard que as executou.
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 do dashboard desse usuário. Ele não pode realizar ações que o usuário não conseguiria realizar diretamente.
- O Operator Connect não usa uma conta de serviço ou credencial compartilhada.
- O dashboard atribui todas as alterações ao usuário conectado. Por exemplo, se um usuário chamado “Alex” atualizar uma campanha pelo Operator Connect, o dashboard mostra Última atualização por Alex, não Última atualização por Operator.
- Quando um usuário perde o acesso na Braze, a Braze revoga o acesso ao Operator Connect na próxima solicitação.
Preços
O uso do Operator Connect conta no mesmo limite diário de custo do Operator aplicável a toda a empresa, assim como o uso pelo dashboard. Como o uso programático normalmente consome mais do que o uso interativo, os participantes da versão 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ê permaneça dentro do limite. Se você 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 na versão beta é gratuita, mas não reflete os preços futuros.
Privacidade e segurança de dados
O Operator Connect segue o mesmo modelo de privacidade e segurança do BrazeAI OperatorTM, incluindo as mesmas relações de processamento de dados. Para saber mais, consulte Privacidade e segurança de dados 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óximos passos
- Configurar o servidor MCP da Braze (pré-requisito para o Operator Connect)
- BrazeAI Operator
- O que você pode fazer com o Operator