> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telloai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 관리

> AI가 통화에서 어떻게 말하고 행동할지 정하는 에이전트를 만들고 설정해요.

## 개요

에이전트는 AI 통화 하나의 성격을 정하는 단위예요. 프롬프트·음성·모델·도구·지식·대화 동작· 상담사 전환·개인정보 보호까지, 통화에 필요한 모든 빌드 설정을 여기서 관리해요. 하나의 에이전트에 **인바운드·아웃바운드 설정이 함께** 저장되고, 용도에 따라 에이전트를 여러 개 만들 수 있어요.

만들기: 왼쪽 목록 위 `+`로 새 에이전트를 만들고, **기본** 탭에서 역할을 적은 뒤 `저장`해요. 도구·지식·시나리오는 저장한 뒤에 연결할 수 있어요.

## 대화를 이끄는 두 방식

Tello는 생성 시 유형을 고르지는 않아요. 대신 에이전트가 대화를 이끄는 방식이 두 가지예요. 간단하면 **프롬프트 방식**(수신은 시스템 프롬프트로, 발신은 통화를 걸 때 준 지시어로 LLM이 대화를 이끌어요)으로 시작하고, 정해진 절차가 필요하면 **시나리오 방식**을 더하면 돼요.

| 항목     | 프롬프트 방식                          | 시나리오 방식                           |
| ------ | -------------------------------- | --------------------------------- |
| 구조     | 단일 프롬프트/지시어                      | 노드 기반 대화 흐름                       |
| 적합한 용도 | 간단한 상담·FAQ·안내                    | 정해진 절차·복잡한 분기(예약·설문 등)            |
| 설정 난이도 | 낮음                               | 중간 \~ 높음                          |
| 대화 제어  | LLM이 자율 판단                       | 노드별 조건 전환                         |
| 입력     | 수신: 기본 탭 시스템 프롬프트 / 발신: 호출 시 지시어 | 수신: 도구 › AI 시나리오 / 발신: 기본 탭 동작 방식 |

발신(아웃바운드) 시나리오는 **자동생성형 🧪**(호출 시 지시어로 즉석 생성)과 **사전설정형 🧪**(미리 만든 흐름대로)으로 나뉘어요.

## 탭별 설정

편집 화면은 6개 탭으로 나뉘어요. 탭 순서대로 살펴봐요.

### 기본

시스템 프롬프트와 통화 기본 동작을 정해요. 상단 `인바운드 | 아웃바운드` 토글로 수신·발신 설정 화면을 전환하며, 두 설정은 한 에이전트에 함께 저장돼요.

| 설정       | 설명                                                                                          |
| -------- | ------------------------------------------------------------------------------------------- |
| 시스템 프롬프트 | 역할·말투·응대 방식을 적는 **수신(인바운드) 프롬프트**. 발신(아웃바운드)은 시스템 프롬프트가 없고, 호출할 때 준 지시어로 동작해요. 기본 템플릿을 제공해요 |
| 최대 통화시간  | 비우면 300초, 저장 시 60\~3600초로 맞춰짐                                                               |
| AI 고지 유형 | 통화 첫머리에 AI임을 밝힘 (AI 비서 / AI 상담사)                                                            |
| 통화 완료 알림 | 켜면 통화 종료 시 문자알림번호로 요약 SMS (발신)                                                              |

### AI 모델

음성 엔진과 관련 설정을 정해요.

| 설정          | 설명                                                                                  |
| ----------- | ----------------------------------------------------------------------------------- |
| 음성 엔진       | Cascading(STT·LLM·TTS 분리 — 프로바이더·모델·보이스를 각각 선택) 또는 S2S(통합, 낮은 지연 — 프로바이더·모델 버전·보이스) |
| 발화 감지 · 추임새 | (Cascading) 끼어들기 감지(빠름/보통/느림), 발화 종료 감지(VAD / AI 판단), 추임새 문구·대기 시간                  |
| 발신 설정       | (아웃바운드) AMD(자동응답 감지)·IVR 자동 네비게이션·자동 재시도. 아래 발신 참고                                  |

BYOK 키·기본 프로바이더는 [AI 모델 관리](/agents/models)에서 계정 단위로 관리해요.

### 도구

통화 중 쓸 도구·지식·시나리오를 연결해요.

| 설정      | 설명                                                               |
| ------- | ---------------------------------------------------------------- |
| 외부 도구   | API·MCP·A2A 연결(예약 저장·외부 조회 등). [도구 관리](/agents/tools)에서 만든 뒤 연결  |
| 지식      | [지식 관리](/agents/knowledge)에 등록한 URL·파일·FAQ를 연결(RAG). 처리 완료 후 연결됨 |
| AI 시나리오 | 키워드로 트리거되는 정해진 흐름. 활성/자동 시작. S2S 미지원                             |

### 보안

**PII 마스킹**을 켜면 고객 발화의 개인정보를 AI 처리 전에 토큰으로 가려요 — 전화번호·주민등록번호·카드번호·계좌번호·이메일·생년월일 6종(이름은 실험 옵션). 금융·의료·공공 업종에 권장하고, **S2S에서는 지원되지 않아요.**

### 전환

통화를 사람 상담사에게 넘겨요. 두 방식 중에 골라요.

* **전화연결(SIP)** — 콜센터 대표번호·휴대폰으로 전환. 표시명과 전환 대상 번호를 지정해요.
* **웹콜연결(WebRTC)** — 상담사가 같은 대화(브라우저)에 참여. 상담사 계정을 만들어요(계정당 최대 5명). 상담사용 수신 URL이 제공돼요.

### 웹챗

웹사이트에 임베드하거나 링크로 공유해 브라우저 상담을 열어요. 수신 채널(음성·텍스트 채팅·영상)을 고르고, **배포 후** 생성되는 Webchat URL·임베드 스크립트를 붙여 넣어요. (S2S는 텍스트 채팅 미지원)

## 발신(아웃바운드) 설정

발신 통화에만 적용되는 옵션이에요 (AI 모델 탭 · 아웃바운드).

* **AMD(자동응답 감지)** — 음성사서함·ARS를 판별해요.
* **IVR 자동 네비게이션** — 목표를 정하면 ARS 메뉴를 자동으로 진행해요.
* **자동 재시도** — 통화중·부재중·음성사서함으로 끝난 통화를 자동 재발신해요(최대 횟수·간격·조건 설정). MCP(`telephony_call`) 발신에만 적용돼요.

## 발행 · 테스트

에이전트에는 **배포(발행)** 개념이 있어요. 상태 배지가 **초안**이면 `배포하기 →`로 배포하고, 배포 후 내용을 바꾸면 **배포됨 · 변경사항 있음**이 되어 `변경사항 배포 →`로 반영하거나 `배포 취소`로 되돌려요. 실제 통화·웹챗에는 **배포된 내용**이 쓰여요.

`테스트 ▶`로 브라우저에서 대화를 미리 확인해요(수신형 동작 기준, 번호 없이 무료). 기존 에이전트는 `수정`을 눌러야 입력이 열려요(웹챗 탭은 예외).

<Warning>
  * **기본** 에이전트는 삭제할 수 없어요.
  * **시나리오**와 \*\*외부 AI 호출(A2A)\*\*은 함께 쓸 수 없어요.
  * **사전설정형**은 시나리오를 완성해야 저장·배포돼요.
  * **S2S 엔진**에서는 시나리오·PII 마스킹·웹챗 텍스트 채팅이 지원되지 않고, 테스트는 음성으로만 가능해요.
  * 테스트 패널은 수신형 전용이에요. 발신은 MCP 클라이언트(`telephony_call`)로 걸어요.
</Warning>

## 관련 문서

* [도구 관리](/agents/tools)
* [지식 관리](/agents/knowledge)
* [AI 모델 관리](/agents/models)
* [전화번호 관리](/calls/numbers)
