블로그 목록

가이드

GPT-Live 1.1 API가 열렸어요. 노을로 한국어 전화 에이전트 시작하기

GPT-Live 1.1의 한국어 목소리 노을로 070 전화를 받고 걸어요. 한국AI통신 매니지드 에이전트를 SDK로 호출하는 방법과 로컬에서 에이전트를 직접 실행하는 방법을 예제로 살펴봐요.

노을(Noeul) 미리듣기 · GPT-Live 1.1

"안녕하세요, 한국 에이아이 통신 고객센터입니다. 무엇을 도와드릴까요?"

안녕하세요. 한국AI통신에서 AI 에이전트를 위한 통화 인프라를 만들고 있어요.

지난 10월에는 ChatGPT Voice에 GPT-Live 1.1이 들어온 소식을 전했어요. 당시에는 OpenAI API에서 1.1을 고를 수 없어서 GPT-Live 1로 070 전화 에이전트를 먼저 준비하는 방법을 소개했죠. 지난 GPT-Live 1.1 글

OpenAI는 11월 19일 변경 로그에 Live API 모델 gpt-live-1.1을 추가했어요. 여러 언어에서 발음과 억양의 일관성, 음성 전사가 개선됐다고 설명해요. 한국AI통신 매니지드 에이전트에도 이번 버전을 추가했어요. OpenAI API 변경 로그

전화에서 쓸 한국어 목소리는 노을이에요

지난 글에 나온 햇살과 한울은 ChatGPT Voice에서 고르는 목소리 이름이에요. OpenAI Live API의 내장 음성 목록에는 한국어 목소리 노을(noeul)이 있어요. 한국AI통신 콘솔에서 GPT-Live 1.1로 바꾸면 노을이 기본으로 선택되고, 38종의 내장 목소리를 같은 한국어 인사로 미리 들어볼 수 있어요. OpenAI 음성 목록 · 매니지드 에이전트 문서

고객이 "금요일 오후 세 시요"라고 말했다가 에이전트의 안내 도중 "아, 세 시 반이요"라고 정정할 수 있죠. 전이중 모델인 GPT-Live는 말하는 중에도 상대의 음성을 들어요. 예약 조회처럼 외부 시스템이 필요한 일은 업무 처리 모델에 맡길 수 있어요. OpenAI GPT-Live 가이드

기존 에이전트에서 모델을 바꿔 070 전화를 받아요

  1. 콘솔의 에이전트 메뉴에서 기존 매니지드 에이전트를 열어요. 처음이라면 새 에이전트 → 지능형 에이전트로 만들어요.
  2. 모델 · 음성 탭의 전이중 (Full duplex) 목록에서 GPT-Live 1.1을 골라요. 모델 목소리에 노을이 표시되면 미리 들어보고 저장해요.
  3. 수신용 070 번호를 처음 연결한다면 전화번호에서 번호 상세를 열어요. 수신 통화 설정에서 에이전트를 선택하고 방금 설정한 에이전트를 지정해요.

전화번호는 에이전트 ID에 연결돼요. 이미 착신 번호가 연결된 에이전트에서 모델을 바꿨다면, 저장한 설정이 그 번호의 다음 통화부터 적용돼요. 매니지드 에이전트 설정 · 070 번호 연결 화면 가이드

테스트 통화에서는 예약 시간을 정정했을 때 최종 시간이 조회에 전달되는지 확인해요. 이어서 통화를 끝내 달라고 요청해 마지막 인사가 들리는지와 회선이 실제로 닫히는지를 확인해요. GPT-Live에서는 회선을 닫는 도구도 업무 처리 모델이 맡아요. GPT-Live 전환 가이드

발신할 때는 SDK에 에이전트 ID를 넘겨요

예약 시스템에서 확인 전화를 걸고 싶다면, 위에서 만든 에이전트의 ID를 발신 요청에 지정해요. Python의 agent_id와 Node.js의 agentId는 서버에 저장한 에이전트를 가리켜요. 모델과 목소리는 그 에이전트 설정에서 읽어요. 발신 전화 생성 API

실행할 서버에 한국AI통신 API 키와 계정 ID를 각각 CLAWOPS_API_KEY, CLAWOPS_ACCOUNT_ID로 설정해요. 아래 예제의 KAT_AGENT_ID에는 만든 에이전트 ID, KAT_FROM에는 같은 계정에 등록된 발신번호, KAT_TO에는 본인이 받을 수 있는 테스트 번호를 넣어요. 코드를 실행하면 실제 발신 요청이 접수돼요.

Python

pip install koreaaitel로 설치하고, 코드에서는 clawops에서 클라이언트를 가져와요. Python SDK 문서

import os

from clawops import ClawOps

client = ClawOps()
call = client.calls.create(
    from_=os.environ["KAT_FROM"],
    to=os.environ["KAT_TO"],
    agent_id=os.environ["KAT_AGENT_ID"],
)
print(call.call_id, call.status)

Node.js

npm install @koreaaitel/sdk로 설치한 뒤 아래 코드를 .mjs 파일에서 실행해요. Node.js SDK 문서

import { ClawOps } from "@koreaaitel/sdk";

const { KAT_FROM, KAT_TO, KAT_AGENT_ID } = process.env;
if (!KAT_FROM || !KAT_TO || !KAT_AGENT_ID) {
  throw new Error("테스트 발신 환경변수를 확인해 주세요.");
}

const client = new ClawOps();
const call = await client.calls.create({
  from: KAT_FROM,
  to: KAT_TO,
  agentId: KAT_AGENT_ID,
});
console.log(call.callId, call.status);

발신 응답을 받으면 통화 ID로 진행 상태를 확인할 수 있어요. 상대가 받았는지는 통화 상세나 상태 웹훅의 answered 이벤트로 확인해요. 발신 전화 생성 API

에이전트 생성도 코드로 하고 싶다면

한국AI통신 REST API에 configuration을 보내면 콘솔과 같은 방식으로 모델과 목소리를 지정할 수 있어요. 생성 응답의 agentId를 위 발신 예제에서 사용해요. 에이전트 생성 API

curl --fail-with-body \
  "https://api.koreaaitel.com/v1/accounts/$CLAWOPS_ACCOUNT_ID/agents" \
  -H "Authorization: Bearer $CLAWOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "예약 안내",
    "instructions": "한국어 존댓말로 예약 문의를 받고 날짜와 시간을 되읽어 확인해 주세요.",
    "configuration": {
      "outputMode": "live",
      "llm": {
        "provider": "openai-live",
        "model": "gpt-live-1.1",
        "voice": "noeul"
      }
    }
  }'

내 컴퓨터에서 에이전트를 직접 실행할 수도 있어요

예약 시스템 조회나 업무 규칙을 내 코드에서 실행하고 싶다면 Python SDK의 ClawOpsAgent로 프로세스를 띄워요. 한국AI통신 전화망으로 070 통화를 받고, LiveKitSession이 통화 음성을 GPTLiveModel 세션에 연결해요. 대화 지침과 도구는 이 코드에서 설정해요. 한국AI통신 LiveKit 연동 문서 · LiveKit GPT-Live 플러그인

아래 예제는 Python 3.12에서 실행해요. CLAWOPS_API_KEY와 CLAWOPS_ACCOUNT_ID를 설정하고, KAT_FROM에는 해당 계정의 테스트용 070 번호를 넣어요. GPT-Live를 사용할 수 있는 OpenAI 프로젝트의 키는 OPENAI_API_KEY로 설정해요.

python -m pip install \
  'koreaaitel[livekit]==0.78.0' \
  'livekit-agents[openai]==1.8.11'

아래 코드를 live_agent.py로 저장해요. session_factory가 통화마다 세션을 만들고, GPTLiveModel에 1.1과 노을을 지정해요.

import argparse
import asyncio
import os

from clawops.agent import ClawOpsAgent
from clawops.agent.livekit import LiveKitSession
from livekit.agents import Agent, AgentSession
from livekit.plugins.openai.realtime import GPTLiveModel


async def create_session(_call):
    session = AgentSession(
        llm=GPTLiveModel(
            model="gpt-live-1.1",
            voice="noeul",
            responses_options={"model": "gpt-5.6-luna"},
        )
    )
    return session, Agent(
        instructions=(
            "한국어로 짧게 답하는 예약 안내 에이전트입니다. "
            "영업시간을 물으면 평일 오전 9시부터 오후 6시까지라고 안내하세요."
        )
    )


async def main(to):
    agent = ClawOpsAgent(
        from_=os.environ["KAT_FROM"],
        session_factory=lambda: LiveKitSession(create_session),
    )
    if to is None:
        await agent.serve()
        return

    try:
        call = await agent.call(to=to)
        await call.wait()
    finally:
        await agent.disconnect()


if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("--to", help="발신할 테스트 번호")
    asyncio.run(main(parser.parse_args().to))

python live_agent.py를 실행한 상태에서 해당 070 번호로 전화해 영업시간을 물어보세요. 상대가 먼저 말을 걸면 예제가 노을 목소리로 응답해요. python live_agent.py --to "$KAT_TO"를 실행하면 내 테스트 번호로 한 번 발신해요. Voice Agent 실행 가이드

SDK 프로세스가 070 번호에 연결돼 있으면 그 프로세스가 걸려 온 전화를 먼저 받아요. 콘솔의 수신 설정과 나란히 시험할 때는 별도 테스트 번호를 사용해요. 070 번호로 전화 받기

AI 음성 요금은 모델 세션 시간으로 계산해요

OpenAI가 공개한 GPT-Live 1.1 활성 음성 단가는 GPT-Live 1과 같은 분당 $0.05예요. 초 단위로 집계하고 업무 처리 모델 사용량은 별도로 계산해요. OpenAI GPT-Live 1.1 요금

매니지드 에이전트에서 모델 세션이 열려 있는 동안에는 무음과 발신 연결 전에 모델을 준비하는 시간도 집계될 수 있어요. 콘솔에서 선택한 대화 모델과 업무 처리 모델의 1분 예상 가격을 확인할 수 있어요. 전화 통화료는 별도예요. 매니지드 에이전트 문서 · 한국AI통신 요금 안내

자주 묻는 질문

OpenAI API 키도 발급받아야 하나요?

매니지드 에이전트는 한국AI통신이 모델 세션을 열어요. 로컬 예제는 자신의 OpenAI API 키로 모델에 연결하므로 모델 요금은 해당 OpenAI 계정에 청구돼요. 두 방식 모두 SDK로 전화할 때는 한국AI통신 API 키를 사용해요. 매니지드 에이전트 문서

GPT-Live 1.1에 외부 TTS를 붙일 수 있나요?

이 모드에서는 GPT-Live가 전화에서 들리는 음성을 직접 만들어요. 콘솔의 내장 목소리 중 하나를 선택해요. 에이전트 모델 설정

한국AI통신 콘솔에서 GPT-Live 1.1 설정하기

관련 글 더 보기

Gemini Live API 로 한국어 voice agent 5분 만들기 — 한국AI통신 070 직접 연결

Google Gemini Live API를 한국AI통신 070 번호에 연결해 한국어 음성 에이전트를 만드는 가이드입니다. Python으로 전화를 걸고 받는 예제와 통화용 시스템 프롬프트, 통화가 끝난 뒤 요약과 녹취록을 확인하는 방법을 다룹니다.

AI 전화 에이전트에 Tool 연동하기: 예약 조회, DB 검색, 외부 API 호출

한국AI통신 Voice Agent SDK의 Tool 등록 기능으로 AI 전화 에이전트가 DB 조회, 예약 확인, 외부 API 호출을 수행하게 만드는 방법. Python/Node.js 실전 코드 포함.

Python AI 전화 SDK — 한국 070 번호로 voice agent 5분 만들기 (ngrok 없이)

Python 한 줄 `pip install clawops[agent,openai]` 로 한국 070 번호 발급 + OpenAI Realtime 음성 에이전트 5분 셋업. ngrok·터널링 없이 로컬에서 바로 받기.

ngrok 없이 로컬에서 음성 에이전트 띄우기 — 5분, 한국AI통신 managed inbound

ngrok·터널링·자체 webhook 서버 없이 로컬 머신에서 한국어 voice agent 띄우는 가이드. 한국AI통신 managed inbound 패턴 + Python 30줄.

GPT-Live 1.1에 한국어 목소리가 생겼어요: API가 열리기 전에 전화 상담원 준비하기

OpenAI GPT-Live 1.1이 한국어를 공식 지원하며 한국어 목소리 '햇살'·'한울'을 공개했어요. 공식 영상과 문서로 확인한 변경점, 아직 열리지 않은 API, 그리고 지금 GPT-Live 1로 070 전화 상담원을 만들어 두면 1.1에서 모델만 바꾸면 되는 이유를 정리했어요.

한국AI통신 AI 전화 API로 시작하기

070 번호 발급부터 AI 음성 통화까지, REST API 몇 줄이면 됩니다.