채팅에 키를 붙여넣지 않고 쓰는 시크릿과 환경 변수

대부분의 실제 앱은 최소한 하나의 시크릿이 필요합니다. 결제 서비스의 키, 이메일 서비스의 키, AI API 키 같은 것들이죠. Mythex에서는 이런 값을 프롬프트에 붙여넣을 필요가 없습니다. 에이전트에 키가 필요하면 채팅에 시크릿 요청 카드가 나타나고, 카드에 값을 입력하면 앱이 읽을 수 있는 프로젝트 시크릿으로 저장됩니다. 키가 대화 내용에 남지 않습니다.

무엇을 하나요

Mythex의 모든 프로젝트는 환경 변수를 저장할 수 있습니다. 환경 변수는 STRIPE_SECRET_KEY처럼 이름이 붙은 값으로, 코드에 값을 직접 적지 않고 앱이 실행될 때 읽어 씁니다. 시크릿은 값을 비공개로 유지해야 하는 환경 변수입니다.

같은 값을 두 곳에서 사용할 수 있습니다.

샌드박스: 작업하는 동안 에이전트가 앱을 빌드하고 실행하는 곳입니다.
게시된 배포본: 방문자가 사용하는 곳입니다.

값을 추가하는 방법은 세 가지입니다.

시크릿 요청 카드: 무언가를 끝내는 데 키가 필요할 때 에이전트가 채팅에 띄웁니다.
프로젝트 설정 → 시크릿: 언제든 값을 추가하거나 수정할 수 있습니다.
채팅에서 /secrets: 요청에 따라 시크릿을 추가하거나 업데이트합니다.

왜 도움이 되나요

AI 에이전트에 키를 전달하는 가장 흔한 방법은 메시지에 키를 붙여넣는 것입니다. 작동은 하지만, 그러면 키가 채팅 기록의 일부가 되어 여러분이 한 다른 말들과 함께 평문으로 남습니다.

시크릿 카드는 값이 대화 기록에 들어가지 않게 합니다. 메시지 입력창이 아니라 카드의 입력란에 값을 넣으면, 값은 프로젝트 시크릿으로 저장됩니다. 에이전트는 샌드박스에서 키를 사용할 수 있는 상태로 작업을 이어 갑니다.

키를 코드가 아니라 프로젝트 설정에 두면 다음과 같은 이점도 있습니다.

키가 소스 관리에 들어가지 않습니다. 코드는 키를 이름으로만 참조하고, 값은 프로젝트 설정에 있습니다.
에이전트와 실행 중인 앱이 같은 설정을 봅니다. 낡아서 어긋나는 복사본이 생기지 않습니다.
코드를 고치지 않고 키를 교체할 수 있습니다. 설정에서 값만 바꾸면 코드는 여전히 이름으로 값을 읽습니다.

환경 변수가 처음이라면 환경 변수와 시크릿이 무엇인지 가이드에서 개념부터 설명합니다.

시크릿 카드 사용법

기능을 요청합니다. 예를 들어 “누군가 가입하면 환영 이메일을 보내 줘”라고 말합니다.
에이전트에 키가 필요하면 시크릿 요청 카드가 채팅에 나타나며, 필요한 값이 목록으로 보입니다.
메시지 입력창이 아니라 카드의 입력란에 값을 입력합니다.
확인합니다. 값이 프로젝트 시크릿으로 저장됩니다.
에이전트가 계속 진행합니다. 샌드박스에서 키를 사용할 수 있습니다.

시크릿을 직접 추가하는 방법

프로젝트 설정을 열고 시크릿을 선택합니다.
STRIPE_SECRET_KEY, OPENAI_API_KEY, 또는 직접 만든 서비스의 인증 정보를 추가합니다.
사용 중인 프레임워크의 표준 방식으로 값을 읽도록 에이전트에 요청합니다. 예를 들어 Node 앱이라면 process.env에서 읽습니다.
게시된 앱에 새 값이 필요하면 다시 게시합니다.

채팅에 /secrets를 입력해 채팅 안에서 추가하거나 업데이트할 수도 있습니다.

게시된 앱에서 시크릿 변경하기

게시된 앱은 게시 시점에 시크릿을 가져옵니다. 시크릿을 추가하거나 바꾼 뒤에는 다시 게시해야 실제 배포본에 새 값이 반영됩니다. 그전까지 방문자는 이전 설정으로 앱을 사용합니다.

보안 팁

시크릿을 저장소에 커밋하지 마세요. 프로젝트 설정에 보관하세요.
권한이 필요한 작업에는 서버 전용 키를 사용하세요. 카드 결제를 하거나 이메일을 보낼 수 있는 키는 방문자 브라우저에 내려가는 코드가 아니라 서버에서 실행되는 코드에 두어야 합니다.
키가 채팅 기록에 노출되었다면 교체하세요. 제공업체에서 새 키를 만들고 이전 키를 폐기한 뒤, 프로젝트 설정의 값을 업데이트하세요. 채팅에 붙여넣은 키는 모두 노출된 것으로 간주하세요.

한계

카드는 사용해야 효과가 있습니다. 메시지 입력창에 키를 그대로 붙여넣으면 그 키는 대화 기록에 남습니다. 제공업체에서 키를 교체하고 저장된 값을 업데이트하세요.
게시된 앱은 새 시크릿이나 변경된 시크릿을 반영하려면 다시 게시해야 합니다.
키를 안전하게 보관한다고 해서 모든 사용이 안전해지는 것은 아닙니다. 키를 어디서 쓰는지도 중요합니다. 권한이 필요한 키는 앱의 서버 쪽에 두세요.

공개 전에 앱을 안전하게 만드는 방법은 AI로 만든 앱을 위한 보안 체크리스트에서 더 볼 수 있습니다.

자세한 내용은 문서에서 확인하세요: 환경 변수와 시크릿, 채팅에서 시크릿 사용하기.