> ## 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.

# 프롬프트 변수

> 문안에 {{이름}}을 적어 두면 통화할 때 실제 값으로 바뀌어요.

## 변수가 뭔가요

문안에 **두 겹 중괄호**로 이름을 적어 두면, 통화가 시작될 때 그 자리가 실제 값으로
바뀌어요.

```
오늘은 {{오늘}}입니다. 예약 가능한 날짜를 안내해 주세요.
```

통화에서는 이렇게 돼요.

```
오늘은 2026년 9월 15일입니다. 예약 가능한 날짜를 안내해 주세요.
```

## 어디에 쓸 수 있나요

* 에이전트 **시스템 프롬프트**
* **첫 인사말**
* **문자 발송** 문안
* 도구의 **엔드포인트 URL**

## 값이 어디서 오나요

세 군데서 와요. 각각 따로 정리해 뒀어요.

<CardGroup cols={3}>
  <Card title="시스템 변수" href="/agents/variables/system">
    날짜·시각·통화 상대처럼 **서버가 알아서 채우는** 값이에요
  </Card>

  <Card title="통화 시작 값" href="/agents/variables/dynamic">
    고객 이름처럼 **통화를 걸 때 내가 넘기는** 값이에요
  </Card>

  <Card title="도구 응답 별칭" href="/agents/variables/tool-response">
    **도구가 돌려준 값**을 뒤 단계에서 부르는 이름이에요
  </Card>
</CardGroup>

## 이름 규칙

| 규칙 | 설명 |
| - | - |
| **한글을 써요** | `{{고객명}}`처럼 한국어 이름을 그대로 쓸 수 있어요 |
| **숫자로 시작 못 해요** | `{{1차상담}}`은 안 돼요. 날짜 더하기 표기와 섞이거든요 |
| **점은 쓸 수 없어요** | `{{주문.번호}}`처럼 점이 든 이름은 시스템 몫이에요 |

공백을 넣은 `{{ 오늘 }}`도 인식해요.

<Warning title="도구 Function Name은 여기 규칙이 아니에요">
  도구의 **Function Name**은 AI가 호출하는 함수 이름이라 **영소문자로 시작**하고 영소문자,
  숫자, 밑줄만 쓸 수 있어요. 대문자와 하이픈, 한글은 안 돼요. 변수 이름과는 다른 규칙이에요.
</Warning>

## 모르는 이름을 적으면

통화 중에 값을 찾지 못한 변수는 **적은 그대로 남아요.** `{{없는이름}}`이라고 적으면
문안에 `{{없는이름}}`이 그대로 들어가요. 첫 인사말이라면 고객이 그 글자를 듣게 되니,
배포 전에 테스트로 한 번 확인하세요.

## 이름이 겹치면

**직접 만든 값이 이겨요.** 통화 시작 값으로 `고객번호`를 넘기면 시스템 값 대신 그 값이
쓰여요. 내가 지은 이름이니 내 뜻대로 쓰이는 것이 맞다는 판단이에요.

## 관련 문서

* [에이전트 관리](/agents/manage)
* [에이전트 크루](/agents/crew)
* [도구 모음](/agents/tools)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.