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

# 도구 응답 별칭

> 도구가 돌려준 값에 이름을 붙여 뒤 단계에서 부르는 방법이에요.

[API 도구](/agents/tools)가 응답에서 꺼낸 값에 별칭을 붙여 두면, 그 뒤 단계에서 그냥
`{{별칭}}`으로 부를 수 있어요.

## 어디서 정하나요

도구 설정의 **응답 변수 별칭** 칸이에요. 두 칸을 짝으로 적어요.

| 칸 | 적는 것 |
| - | - |
| **응답 변수 이름** | 프롬프트에서 부를 이름. 예) `주문상태` |
| **추출 식** | 응답에서 그 값을 꺼내는 경로. 예) `{{ $.data.status }}` |

이름에 **한글을 써도 돼요.** 이 이름은 통화 중에 값으로 바뀌어 사라지니 AI가 볼 일이
없거든요.

<Warning title="점은 쓸 수 없어요">
  `주문.상태` 처럼 **점이 든 이름은 서버 몫**이에요. 점이 하나라도 있으면 「서버가 채우는
  값」으로 갈리고, 저작자가 지은 이름으로 안 읽혀요. 점 대신 붙여 쓰거나 밑줄을 쓰세요.
</Warning>

## 어디에 쓰나요

| 쓰는 곳 | 설명 |
| - | - |
| **다음 도구의 인자** | 앞서 부른 도구의 응답으로 인자를 채워요 |
| **엔드포인트 URL** | 주소의 `{{별칭}}` 자리를 채워요 |
| **크루 전환 값** | 다음 멤버에게 넘길 값으로 써요 |

## 값 변환과 함께

꺼낸 값의 모양이 마음에 안 들면 [값 변환](/agents/tools)을 걸어요. API가 `20260914` 를
돌려줘도 「2026년 9월 14일」로 바꿔 담을 수 있어요.

## 주의사항

<Warning title="같은 이름을 내는 도구가 둘이면">
  여러 도구가 같은 이름의 값을 내면 통화에서 **나중에 부른 도구의 값**이 들어가요.
  크루에서는 배포 전 확인 창이 그런 연결을 짚어 줘요.
</Warning>

* 도구를 **발행**해야 통화에서 보여요. 발행하지 않은 도구는 아예 불리지 않아요.
* 「응답 변수」의 **꺼낼 값** 자체는 아직 통화에 반영되지 않아요. 화면에도 「아직 통화에
  반영되지 않아요」라고 적혀 있어요. 지금은 저장만 돼요.

## 관련 문서

* [프롬프트 변수](/agents/variables)
* [도구 모음](/agents/tools)
* [에이전트 크루](/agents/crew)


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