OpenAI Agents SDK로 WhatsApp 에이전트를 만드는 방법

OpenAI Agents SDK는 에이전트를 만들기 위한 OpenAI의 오픈 소스 프레임워크입니다. 지침이 있는 모델, 호출할 수 있는 도구, 다른 에이전트로의 핸드오프, 입력과 출력에 대한 가드레일을 작업이 끝날 때까지 루프로 실행합니다. 에이전트를 만들기에 훌륭한 방법이지만, 그것만으로는 WhatsApp 번호, 팀 인박스, 템플릿 메시지, 사람이 이어받는 방법까지 제공하지는 않습니다. MonoChat의 Agent Harness에서는 OpenAI Agents SDK를 AI 하네스로 선택하고, 플로우에 AI 에이전트 노드를 놓고, WhatsApp을 연결해 테스트하면 나머지는 MonoChat이 처리합니다.

이 가이드에서는 SDK가 제공하는 것, MonoChat에서 OpenAI 에이전트를 사용하는 세 가지 방법, 단계별 설정, 그리고 고객이 에이전트를 신뢰할 수 있는지를 좌우하는 WhatsApp 고유의 세부 사항을 다룹니다.

OpenAI Agents SDK가 제공하는 것

SDK는 몇 가지 핵심 개념을 중심으로 만들어졌습니다.

• 에이전트: 업무를 설명하는 지침이 있는 모델.
• 도구: “주문 조회”, “예약 가능 시간 확인”처럼 에이전트가 호출할 수 있는 함수와 MCP 서버.
• 핸드오프: 일반 지원 에이전트에서 반품 전문 에이전트로 넘기는 것처럼, 한 에이전트가 작업을 전문 에이전트에게 넘기는 것.
• 가드레일: 원하지 않는 입력이나 출력을 막기 위해 에이전트와 함께 실행되는 점검.
• 세션과 추적: 턴 사이의 메모리와 에이전트가 한 일을 단계별로 기록한 내용.

이 모든 것이 에이전트 하네스입니다. 모델이 한 번 답하고 끝나는 대신 행동하고, 작업을 점검하고, 계속 이어가게 하는 루프입니다. 고객 메시징에서는 반품 정책을 설명하는 것과 실제로 반품을 생성하는 것의 차이가 여기서 나옵니다.

WhatsApp이 더하는 과제

에이전트를 만드는 것은 일의 절반입니다. WhatsApp에서 고객 앞에 세우려면 다음을 처리해야 합니다.

• WhatsApp Business Platform. 공식 API 연결, 인증된 비즈니스, 승인된 번호.
• 24시간 창. 자유 형식 답변은 고객의 마지막 메시지 후 24시간 이내에 허용되며, 그 이후에는 승인된 템플릿이 필요합니다.
• 정책. 2026년 1월 15일부터 WhatsApp은 범용 AI 어시스턴트를 플랫폼에서 제외합니다. 자사 고객을 응대하는 에이전트는 허용되며, 자동 응답에는 사람으로 연결되는 명확한 경로가 있어야 합니다.
• 사람. 일부 대화는 팀이 이미 사용하는 도구 안에서 기록이 그대로 유지된 채 사람에게 가야 합니다.
• 다른 채널. Instagram, Messenger, 웹사이트에서 문의하는 고객도 같은 답변을 기대합니다.

MonoChat이 에이전트 주변의 이러한 부분을 처리하므로, 여러분은 에이전트 자체에 집중할 수 있습니다.

MonoChat에서 OpenAI 에이전트를 사용하는 세 가지 방법

옵션	실행 위치	필요한 것
OpenAI Agents SDK	MonoChat 내부	추가로 필요 없음, 보유한 AI 모델 사용
OpenAI Agents API (OpenAI 호스팅)	OpenAI 클라우드	본인의 OpenAI API 키
커스텀 (자체 Agents SDK 서비스)	자체 서버	엔드포인트 URL과 공유 시크릿

아무것도 배포하지 않고 OpenAI 방식의 에이전트를 원한다면 OpenAI Agents SDK 하네스로 시작하세요. 에이전트가 이미 OpenAI의 호스팅 플랫폼에 있다면 OpenAI Agents API를 선택하세요. 개발자가 SDK로 자체 도구, 핸드오프, 테스트를 갖춘 에이전트를 직접 작성했고 그 코드를 계속 실행하려면 커스텀을 선택하세요. 나만의 AI 에이전트를 WhatsApp에 연결하는 방법을 참고하세요.

단계별 안내: WhatsApp의 OpenAI Agents SDK 에이전트

1. AI 하네스 추가

MonoChat에서 AI 하네스를 추가하고 제공업체로 OpenAI Agents SDK를 선택하세요. MonoChat 내부에서 실행되며 이미 설정한 AI 모델을 사용하므로, 이 단계에는 별도의 키나 서버가 필요 없습니다.

2. 플로우에 AI 에이전트 노드 추가

WhatsApp 대화를 받는 플로우에 AI 에이전트 노드를 추가하고 하네스를 선택하세요. 에이전트의 지침을 작성합니다. 누구를 응대하는지, 무엇을 할 수 있는지, 절대 하면 안 되는 일은 무엇인지, 언제 상담원에게 넘기는지를 적으세요.

3. 메인, 폴백, 고속 모델 선택

모든 AI 에이전트 노드에는 세 가지 모델 역할이 있습니다.

• 메인 모델은 추론하고 답변을 작성합니다.
• 폴백 모델은 소프트 한도에 도달하거나 실패하면 이어받습니다.
• 고속 모델은 백그라운드 작업을 처리합니다.

특이한 대화 하나가 큰 비용을 만들지 않도록 실행당 예산 한도를 추가하세요. 폴백을 어떻게 고를지 확신이 서지 않는다면 고객 응대 AI 에이전트에 폴백 모델이 필요한 이유를 읽어 보세요.

4. 도구 연결

가장 자주 들어오는 요청에 맞는 도구를 에이전트에 제공하세요.

• AI 함수 도구로 구조화된 입력을 사용해 자체 API를 호출합니다.
• MCP 연동으로 MCP를 지원하는 시스템의 도구를 사용합니다.
• AI 지식 베이스로 문서와 정책에 근거한 답변을 제공합니다.
• 맞춤 함수로 대화 안에서 실행되는 로직을 처리합니다.

충분히 테스트하지 못한 열다섯 개보다 잘 고른 세 개가 낫습니다. 실제 대화를 확인한 뒤에 더 추가하세요.

5. WhatsApp(그리고 다른 모든 채널) 연결

공식 Meta Business Partner인 MonoChat을 통해 WhatsApp Business 번호를 연결하세요. 같은 플로우를 Instagram, Messenger, TikTok, Telegram, 웹 채팅, SMS, 음성에서도 실행할 수 있으므로 하나의 에이전트가 모든 채널을 담당합니다.

6. 실제 메시지로 테스트

지난달 대화를 테스트 세트로 사용하세요. 화가 난 고객, 모호한 질문, 한 메시지에 담긴 여러 요청, 바로 사람을 찾는 고객 같은 어려운 사례도 포함하세요. 도구 호출, 어조, 상담원 연결을 확인한 다음 운영을 시작하세요.

WhatsApp에서 잘 통하는 패턴

메시지당 질문 하나. 웹 채팅용으로 만든 에이전트는 긴 목록으로 답하는 경향이 있습니다. 휴대폰에서는 짧은 메시지와 한 번에 하나의 명확한 질문이 고객에게서 더 나은 답을 끌어냅니다.

되돌릴 수 없는 작업 전에는 확인. 취소, 환불, 예약 변경 전에는 에이전트가 제안하고 고객이 확인하게 하세요.

전문가는 핸드오프로, 사람은 인박스로. SDK의 핸드오프는 에이전트 간(영업, 지원, 반품) 라우팅에 좋습니다. 사람으로의 상담원 연결은 대화가 전체 기록과 함께 도착하는 MonoChat의 공유 팀 인박스에서 이루어집니다.

한계를 명시하는 지침. “€50까지의 환불은 승인할 수 있고, 그 이상은 결제 팀에 연결합니다.” 모호한 규칙보다 명시적인 숫자가 낫습니다.

비즈니스 범위 안에서. 고객을 돕는 에이전트는 WhatsApp에서 허용됩니다. 무엇이든 답하는 에이전트는 WhatsApp의 2026년 규칙을 위반할 위험이 있습니다. 어디까지가 허용되는지는 WhatsApp AI 챗봇 정책 가이드에서 설명합니다.

비용

MonoChat 요금제, AI 모델 사용료, Meta의 WhatsApp 메시지 요금, 세 가지가 더해집니다. 2026년 10월 1일부터 Meta는 비즈니스 번호당 월 처음 1,000건 이후의 서비스 답변에 요금을 부과합니다. WhatsApp API 요금 가이드를 참고하세요.

AI 측면에서는 자체 제공업체 키를 사용하면 MonoChat이 추가 요금을 붙이지 않습니다. 실행당 예산, 백그라운드 작업용의 더 저렴한 고속 모델, 안정적인 폴백이 있으면 청구액을 예측할 수 있습니다.

특정 방식에 묶이지 않습니다

Agent Harness에서는 모델뿐 아니라 프레임워크도 선택할 수 있습니다. 나중에 Claude Agent SDK, Pi, Claude Managed Agents 또는 자체 프레임워크를 써 보고 싶다면 다른 AI 하네스를 추가하고 AI 에이전트 노드가 이를 가리키게 하세요. 채널, 도구, 상담원 연결은 그대로 유지됩니다. 모든 제공업체는 Agent Harness 페이지에서 비교해 보세요.