저장과 게시
save_agent는 현재 설정을 저장해요. create_agent_version으로 현재 설정의 버전을 저장하고, publish_agent_version으로 저장한 버전을 프로덕션에 지정해요. 번호 연결은 set_number_agents로 따로 바꿔요. 자세한 동작은 에이전트 버전 관리에 있어요.
안전하게 실행하기
실제 전화 발신과 운영 설정 변경 전에는 대상과 내용을 확인하세요. 승인 화면과 도구 실행 방식은 사용하는 AI 앱의 설정을 따라요.- 실행 전 확인:
place_call의 전화 발신,launch_campaign·resume_campaign의 대량 발신 시작·재개,publish_agent_version의 게시 대상을 확인하세요. 플러그인의 스킬은 실행 전에 대상과 내용을 요약해 확인을 받도록 안내해요. 계획이나 준비를 요청한 것은 실행 승인이 아니에요. - 실행 키(
execution_key):place_call,launch_campaign,resume_campaign에는 실행 키가 필요하고,pause_campaign과cancel_campaign에서는 선택 사항이에요. 실행하려는 의도마다 새 키를 만들고, 같은 요청을 다시 보낼 때만 같은 키를 써요. 같은 키로 다시 호출하면 서버는 새로 실행하지 않고 앞선 결과를 돌려줘요. - 결과를 알 수 없을 때: 응답이
unknown이면 자동으로 다시 실행하지 마세요.get_call,list_calls,get_campaign으로 실제 상태를 읽어 확인한 뒤, 더 실행할지는 사용자가 정해요. - 통화 원문과 비밀값:
get_call은 통화 원문을 기본으로 빼고, 요청할 때만 포함해요.get_tool과list_tools의 인증 헤더 같은 비밀값은 가려져서 나와요.
get_call이나 get_campaign으로 확인하세요.
공개 도구 목록
외부 AI 앱에 공개된 도구예요. 구분은 읽기만 하는 조회, 설정을 바꾸는 저장, 실제 영향이 큰 실행이에요. 연결한 계정의 권한에 따라 호출이 거절될 수 있어요.워크스페이스 확인과 전환
모델과 입력 스키마 탐색
에이전트, 플로우, 버전
시작 템플릿
메뉴얼과 외부 연동 도구
지식 베이스
보이스
보유 전화번호
통화 조회와 발신
대량 발신
발신 대상 시트
고객과 고객 속성
도구가 지원하지 않는 일도 있어요. 파일 업로드로 지식을 등록하는 것, 전화번호를 구하거나 해지하는 것, 음성으로 시험하는 것은 대시보드에서 해요.
오류와 예외
- 권한 오류: 연결한 워크스페이스와 계정의 역할을 확인하세요.
- 실행 결과가
unknown: 같은 요청을 다시 보내지 마세요.list_calls에서 받는 번호와 시작 시각으로 통화를 찾거나get_campaign으로 대량 발신 상태를 확인하세요. - 워크스페이스 전환:
set_organization은 같은 연결을 쓰는 모든 대화에 적용돼요. 전환 뒤에는 리소스 ID를 다시 조회하세요.
관련 문서
- MCP: 직접 연결과 로그인
- 플러그인: 업무별 스킬과 MCP 연결 설치
- 에이전트 버전 관리: 저장한 버전을 프로덕션에 지정하기