# 음성 AI 프롬프트에서 커스텀 변수 지원

**목차**

* [프롬프트의 커스텀 변수 지원이란?](#프롬프트의-커스텀-변수-지원이란)
* [커스텀 변수 지원의 주요 장점](#커스텀-변수-지원의-주요-장점)
* [프롬프트에 커스텀 변수를 추가하는 방법](#프롬프트에-커스텀-변수를-추가하는-방법)
* [커스텀 변수 사용 모범 사례](#커스텀-변수-사용-모범-사례)
* [자주 묻는 질문](#자주-묻는-질문)

## **프롬프트의 커스텀 변수 지원이란?**

오랫동안 기다려온 음성 AI(Voice AI) 프롬프트에서의 커스텀 변수 지원 기능이 드디어 출시되었습니다! 이 기능을 통해 연락처별 세부 정보를 프롬프트에 동적으로 삽입하여 음성 AI 상호작용을 개인화할 수 있으며, 대화를 더욱 맥락적이고 매력적으로 만들 수 있습니다.

## **커스텀 변수 지원의 주요 장점**

음성 AI 프롬프트에서 커스텀 변수를 사용하면 대화 흐름이 개선되고 다음과 같은 이점을 얻을 수 있습니다:

* **개인화된 상호작용** – 음성 에이전트가 이제 특정 연락처 세부 정보를 참조할 수 있어 대화가 더 자연스럽고 맞춤화됩니다.
* **향상된 맥락 인식** – 음성 AI가 기존 고객 세부 정보를 가져와 사용할 수 있어 더 적절한 응답을 제공하는 능력이 향상됩니다.
* **개선된 통화 경험** – 에이전트가 고객 이름과 기타 관련 정보를 사용할 수 있어 통화가 더욱 인간적으로 느껴집니다.
* **원활한 통합** – 간단한 태그 형식을 사용하여 커스텀 변수를 쉽게 추가할 수 있습니다.

## **프롬프트에 커스텀 변수를 추가하는 방법**

음성 AI 프롬프트에 커스텀 변수를 추가하는 것은 간단합니다. 다음 단계를 따라하세요:

* **에이전트 목표로 이동** – 플랫폼의 음성 AI 설정으로 이동합니다.
* **고급 목표 선택** – 에이전트 목표(Agent Goals) 섹션에서 고급 목표(Advanced Goals) 설정에 접근합니다.

![음성 AI 고급 목표 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155042229811/original/Cbzdtq6Mk65pCgeDc4p1LZw-nbpAaxyCpg.png?1740502713)

* **커스텀 변수 선택** – 사용 가능한 태그 목록에서 추가하려는 변수를 선택합니다.
* **변수 수동 삽입** – {{contact.name}} 형식을 사용하여 특정 연락처의 이름을 삽입하거나 필요에 따라 다른 미리 정의된 변수를 사용합니다.

![커스텀 변수 삽입](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155042229840/original/v77nurRdT8DGpKr_jjodtnaGp6SmyBGpcw.png?1740502738)

* **저장 및 배포** – 프롬프트 설정이 완료되면 변경 사항을 저장하고 음성 에이전트를 배포하여 대화를 개선합니다.

## **커스텀 변수 사용 모범 사례**

커스텀 변수의 효과를 극대화하려면 다음 모범 사례를 따르세요:

* **변수를 신중하게 사용** – 사용하는 변수가 대화에 가치를 더하고 명확성을 향상시키는지 확인하세요.
* **배포 전 테스트** – 실제 운영에 들어가기 전에 테스트 통화에서 커스텀 변수가 올바르게 채워지는지 확인하세요.
* **자연스러운 프롬프트 유지** – 너무 많은 변수로 프롬프트를 과부하시키지 마세요. 대화가 로봇 같이 들릴 수 있습니다.
* **고객 데이터 정기 업데이트** – 프롬프트에서 오래된 정보가 사용되지 않도록 고객 세부 정보를 최신 상태로 유지하세요.

***

## **자주 묻는 질문**

**Q: 어떤 유형의 커스텀 변수를 사용할 수 있나요?** A: {{contact.name}}, {{contact.phone}} 및 고객 세부 정보를 저장하는 기타 미리 정의된 필드와 같은 변수를 사용할 수 있습니다.

**Q: 이 기능이 모든 음성 AI 에이전트에서 작동하나요?** A: 네, 커스텀 변수 지원은 고급 목표(Advanced Goals)로 설정된 모든 음성 AI 에이전트에서 사용할 수 있습니다.

**Q: 나만의 커스텀 변수를 만들 수 있나요?** A: 현재는 연락처 세부 정보와 관련된 시스템 정의 변수를 사용할 수 있습니다. 추가 커스텀 변수는 향후 업데이트에서 지원될 수 있습니다.

**Q: 커스텀 변수가 작동하는지 어떻게 테스트할 수 있나요?** A: 변수를 설정한 후 테스트 통화를 진행하여 올바른 세부 정보가 대화에 반영되는지 확인하세요.

***

## 다음 단계

지금 바로 커스텀 변수를 활용하여 더욱 개인화되고 효과적인 음성 AI 상호작용을 만들어보세요! 에이전트 목표(Agent Goals)로 이동하여 변수를 설정하고 고객 경험을 향상시키세요.

***

*원문 최종 수정: 2025년 2월 25일 화요일 오전 11:00* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/ai-ai-employee/voice-ai-custom-variable-support-in-prompt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.