AI 앱에서 대화만으로 음성 에이전트를 만들고 수정하세요. 대시보드를 열지 않아도 됩니다.
워크플로우
에이전트 생성
create_agent 도구를 사용하세요.
대화 예시:
"인바운드 예약 확인 에이전트를 만들어줘.
고객 이름을 확인하고, 예약 정보를 조회한 뒤 안내하는 역할이야."
주요 파라미터
| 파라미터 | 설명 | 예시 |
|---|
name | 에이전트 이름 | "예약 확인 에이전트" |
agent_type | single_prompt 또는 flow | "single_prompt" |
prompt | 시스템 프롬프트 | 역할, 규칙, 처리 업무 정의 |
data | 상세 설정 | 아래 참고 |
data 주요 필드:
| 필드 | 설명 |
|---|
first_message | 통화 시작 시 에이전트가 말할 첫 메시지 |
voice | 음성 설정 (TTS 모델, 목소리) |
tools | 에이전트에 연결할 도구 목록 |
llm | LLM 모델 설정 |
에이전트 수정
update_agent 도구로 기존 에이전트를 수정하세요.
대화 예시:
"에이전트 A의 프롬프트에 '통화 종료 전에 다른 문의사항이 있는지 물어보세요'를 추가해줘"
"에이전트 A의 첫 인사를 '안녕하세요, 예약 확인 도우미입니다'로 변경해줘"
update_agent는 지정한 필드만 업데이트합니다 (PATCH 방식). 나머지 설정은 그대로 유지합니다.
에이전트 조회
| 도구 | 설명 |
|---|
list_agents | 조직의 모든 에이전트 목록 조회 |
get_agent | 특정 에이전트의 상세 설정 조회 |
"현재 에이전트 목록을 보여줘"
"에이전트 A의 현재 프롬프트를 보여줘"
실패 시 대응
| 상황 | 원인 | 해결 |
|---|
| ”agent_id를 찾을 수 없습니다” | 잘못된 UUID | list_agents로 정확한 ID를 확인하세요 |
| ”인증 실패” | OAuth 만료 또는 API 토큰 오류 | 재인증하거나 토큰을 확인하세요 |
| 수정이 반영되지 않음 | 운영 번호가 이전 버전에 매핑됨 | 대시보드에서 최신 버전을 게시하세요 |
관련 문서
에이전트 생성, 에이전트 수정, create_agent, update_agent, get_agent, list_agents, 프롬프트, 에이전트 관리
