콘텐츠로 건너뛰기

Operator Connect

Operator Connect를 사용하면 이미 사용 중인 AI 도구(Claude, Cursor 또는 기타 MCP 클라이언트)에서 브리프를 작성하고, BrazeAI OperatorTM가 Braze 대시보드에서 이를 구현합니다.

시작하기 전에

Operator Connect는 단계별 승인을 사용하지 않습니다

Operator Connect는 대시보드의 BrazeAI Operator보다 명시적 승인을 적게 요청합니다. 그러나 로그인된 대시보드 사용자의 권한을 그대로 따르므로, 해당 사용자가 대시보드에서 수행할 수 있는 작업만 실행할 수 있습니다. Operator Connect를 사용하기 전에 해당 권한을 검토하세요. 에이전트도 동일한 접근 권한을 갖습니다.

Operator는 현재 캠페인 또는 Canvases를 실행할 수 없습니다.

Operator가 변경할 수 있는 범위를 제한하려면 Operator Connect 전용으로 범위가 지정된 권한을 가진 Braze 사용자를 생성하세요. 설정 방법은 회사 사용자 관리를 참조하세요. 이렇게 하면 대시보드에서 Operator의 변경 사항을 더 쉽게 식별할 수 있습니다. 팀에서 단계별 승인이 필요한 경우, 대시보드에서 BrazeAI Operator를 사용하세요.

Operator Connect는 에이전트 기반의 판단 집약적 작업에 사용하세요

브리프에서 캠페인을 구축하거나, Canvas를 재구성하거나, 워크스페이스에 대한 복잡한 질문에 답변하는 등의 작업에 활용하세요. Operator Connect는 대량, 고빈도 프로그래밍 방식의 작업에는 적합하지 않습니다. 이러한 워크플로에는 Braze REST API를 사용하세요.

전제 조건

Operator Connect를 사용하기 전에 다음 사항을 확인하세요.

전제 조건 설명
호스팅된 Braze MCP 서버 Operator Connect는 호스팅된 OAuth 기반 Braze MCP 서버를 통해서만 제공됩니다. 로컬 API 키 MCP 서버를 사용하는 고객은 먼저 원격 호스팅 서버로 마이그레이션해야 합니다. Braze MCP 서버 설정을 참조하세요.
워크스페이스에 Operator 활성화 워크스페이스에 BrazeAI Operator가 활성화되어 있어야 합니다.
MCP 서버 사용 권한 대시보드 사용자에게 “Use MCP Server” 권한이 필요합니다.

액세스 활성화 후 MCP 서버를 제거하고 다시 추가하세요

Braze가 계정에 Operator Connect를 활성화하면 기존 MCP 연결이 자동으로 새 범위를 인식하지 못합니다. Braze에서 액세스가 활성화되었음을 확인한 후, 클라이언트에서 Braze MCP 서버를 제거하고 다시 추가하세요. 도움이 필요하면 문제 해결을 참조하세요.

Operator Connect로 할 수 있는 작업

Operator Connect는 대시보드의 BrazeAI Operator와 동일한 작업을 수행할 수 있으며, 다음이 포함됩니다.

  • Campaigns 및 Canvases 구축 및 편집
  • Segments 생성 및 업데이트
  • 이메일, SMS, 푸시, 인앱 메시지 문구 및 템플릿 초안 작성
  • Content Blocks 관리
  • 보고서 생성 및 워크스페이스 데이터 기반 질문 답변

전체 기능 목록은 Operator로 할 수 있는 작업을 참조하세요.

Operator Connect 작동 방식

자연어로 프롬프트를 작성하세요. MCP 클라이언트는 일반적으로 브리프에서 Operator Connect를 자동으로 선택하므로, Operator나 도구 이름을 직접 지정할 필요가 없습니다.

Operator가 완료할 수 있는 작업인데도 클라이언트가 Operator Connect를 건너뛰는 경우, Operator Connect를 사용하도록 더 명시적인 지시를 추가할 수 있습니다.

프롬프트를 전송하면 클라이언트가 이를 Operator에 제출하고 결과를 자동으로 가져옵니다. 호스팅된 Braze MCP 서버의 세 가지 도구가 이를 처리합니다.

  • ask_operator — 자연어 프롬프트를 제출하고 작업 ID를 반환합니다. Operator는 작업을 비동기적으로 실행합니다.
  • get_operator_result — 지정된 작업 ID의 결과를 가져옵니다.
  • cancel_operator_job — 실행 중인 작업을 중지합니다.

프롬프트 예시

자연어 브리프로 시작하세요. 다음은 몇 가지 예시입니다.

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.

예상되는 사항

Operator Connect는 동기식 API 호출과 다르게 작동합니다. 다음 사항을 미리 고려하세요.

비동기 응답

응답은 몇 초가 아닌 몇 분이 소요됩니다. Operator Connect는 각 작업을 완전한 에이전트 세션으로 실행하며, 대시보드에서 동일한 작업을 수행하는 것과 비슷한 시간이 걸립니다. Operator Connect 출력을 다른 사람이나 다운스트림 시스템과 공유하는 경우 이를 감안하세요. 이러한 도구를 직접 호출하는 커스텀 에이전트를 구축하는 경우, 즉각적인 응답을 기대하지 말고 get_operator_result를 폴링하도록 설계하세요. 응답은 구조화된 출력 형식 없이 텍스트로 반환됩니다.

관측 뷰 없음

이 베타에서는 Operator Connect 사용에 대한 전용 대시보드 UI, 세션 로그 또는 관측 뷰가 없습니다. Operator가 수행한 작업은 해당 대시보드 사용자의 일반 기여도로 대시보드에 표시됩니다.

인증 및 권한

Operator Connect는 Braze MCP 서버와 동일한 로그인을 사용하며, 별도의 로그인 없이 일반 Braze 자격 증명을 사용합니다. Operator Connect는 공유 API 키가 아닌 대시보드 사용자 계정에 액세스를 연결합니다. 이는 다음을 의미합니다.

  • Operator는 해당 사용자의 정확한 대시보드 권한으로 작동합니다. 사용자가 직접 수행할 수 없는 작업은 실행할 수 없습니다.
  • 대시보드는 모든 변경 사항을 로그인된 사용자에게 귀속시킵니다. 감사를 용이하게 하려면 Operator Connect 전용 Braze 계정을 사용하세요. 시작하기 전에를 참조하세요.
  • 사용자가 Braze 액세스를 잃으면 Operator Connect 액세스도 함께 잃게 됩니다.

가격 책정

베타 기간 동안 Operator Connect 사용량은 대시보드 사용량과 동일한 회사 전체 일일 Operator 비용 한도에 포함됩니다. 프로그래밍 방식의 사용은 일반적으로 인터랙티브 사용보다 더 많이 소비하므로, 베타 참가자에게는 프로그램 기간 동안 일시적으로 상향된 일일 한도가 제공됩니다.

  • 상향된 한도는 베타 프로그램 기간 동안만 적용되며 변경될 수 있습니다.
  • Braze는 한도 내에 머물 것을 보장할 수 없습니다. 한도에 도달하면 고객 성공 매니저에게 문의하세요.

Operator Connect는 정식 출시 시 유료 기능이 될 예정입니다. 베타 참여는 무료이지만 향후 가격 책정을 반영하지는 않습니다.

데이터 프라이버시 및 보안

Operator Connect는 동일한 데이터 처리자 관계를 포함하여 BrazeAI OperatorTM와 동일한 프라이버시 및 보안 모델을 따릅니다. 자세한 내용은 BrazeAI Operator의 데이터 프라이버시 및 보안을 참조하세요.

문제 해결

액세스 활성화 후 Operator 도구가 표시되지 않는 경우

Braze가 계정에 Operator Connect를 활성화하면 기존 MCP 클라이언트 연결이 업데이트된 액세스 권한을 자동으로 인식하지 못할 수 있습니다. 프롬프트를 제출했을 때 인증 오류가 발생하거나 클라이언트에 Operator 도구가 표시되지 않는 경우:

  1. MCP 클라이언트에서 Braze MCP 서버 연결을 제거합니다.
  2. 엔드포인트 URL(https://mcp.braze.com/mcp(미국) 또는 https://mcp.braze.eu/mcp(EU))을 사용하여 Braze MCP 서버를 다시 추가합니다.
  3. OAuth 로그인 흐름을 다시 완료합니다.

다시 추가한 후 클라이언트는 Operator Connect를 포함한 업데이트된 액세스 권한으로 등록됩니다. 문제가 계속되면 고객 성공 매니저에게 문의하세요.

다음 단계

New Stuff!