프롬프트 예시

관리자 페이지 위치: AI Chat (/agent) 또는 관리자 페이지의 플로팅 Ask AI 버튼. MCP를 통해 연결된 모든 AI 클라이언트에서도 동일한 프롬프트를 사용할 수 있습니다.

작동 내용

다음 프롬프트는 요청 방법을 보여줍니다. 각 프롬프트에는 어시스턴트가 백그라운드에서 수행하는 작업, 필요한 권한 범위(외부 클라이언트 또는 키용), 승인을 요구하는 지점이 나열되어 있습니다. 예시 값을 본인 환경에 맞게 변경하세요.

채팅 창에 비밀 정보를 직접 입력하지 마세요

비밀번호, API 키, 토큰의 경우 AI Chat 입력창 옆의 Secret 필드를 사용하세요(details). AI는 실제 값 대신 비밀 정보를 나타내는 플레이스홀더만 보게 됩니다. 외부 AI 클라이언트를 사용하는 경우 비밀 정보가 해당 클라이언트를 거치므로 관리자 페이지에서 직접 입력하는 것을 권장합니다.

현재 상태 확인

Check my setup progress and tell me the next three things to do, in order.

어시스턴트는 setup_checklist 및 system_health(권한 범위: admin:read)을(를) 호출하고 실제 상태를 바탕으로 답변합니다. Setup progress checklist을(를) 참조하세요.

초기 설정

Help me finish the initial setup. Go through the checklist, explain each open step
in one sentence, ask me for what you need, and show me every change before it is applied.

MCP 프롬프트 initial-setup과(와) 동일합니다. admin:read 및 수락하는 단계의 권한 범위가 필요합니다. AI Chat에서 각 변경 사항에 대한 확인 카드가 표시됩니다.

Proxmox VE 클러스터 추가

I want to sell servers from my Proxmox VE cluster at https://pve.example.com:8006.
Add it, test the connection, create a zone called "New York" in the US, attach the cluster
to it, and then propose starter plans.

작동 방식:

1. 어시스턴트는 API 토큰 ID(user@realm!tokenid)와 시크릿을 요청합니다. 시크릿을 Secret 필드에 입력하세요. 먼저 제한된 권한의 토큰을 만드세요: Proxmox VE.
2. proxmox_add, proxmox_test, zone_create, proxmox_attach_zone을(를) 호출합니다.
3. plans_from_offerings을(를) 사용하여 플랜을 제안하고 승인을 기다립니다(다음 예시 참조).

권한 범위: infra:write, secrets:write, catalog:write, admin:read.

40% 마진을 적용한 상품 테이블 생성

Suggest a starter plan table from my CloudStack offerings. My costs are $4 per vCPU per month,
$2 per GB of RAM per month and $0.08 per GB of disk per month. Use a 40% margin, show me the
table with cost, price per month and price per hour, and create the plans only after I approve.

어시스턴트는 plans_from_offerings을(를) margin_pct 40 및 비용과 함께 호출합니다. 마진은 판매가 중 이익이 차지하는 비중입니다(40% 마진의 경우 비용이 $60인 상품이 $100에 판매됨). 첫 번째 호출은 미리보기만 반환합니다. 승인하면 apply=true을(를) 사용하여 도구를 다시 호출하며, 이는 가격이 포함되어 있으므로 한 번의 확인을 거쳐 요금제를 한 번에 생성합니다. Proxmox의 경우 backend_id 및 기본 크기 목록(1, 2, 2, 4 vCPU)을 사용합니다. 범위: catalog:write, admin:read. Plans 참조.

이메일 설정 및 테스트 메시지 전송

Configure outgoing email with smtp.example.com, port 587, STARTTLS, user "mailer@example.com",
sender name "Example Cloud", sender address "no-reply@example.com". Use my Secret field for the
password "smtp_password". Then send a test email to admin@example.com.

어시스턴트는 smtp_get, smtp_configure, smtp_test을(를) 호출하고 메시지가 수락되었는지 알려줍니다. 권한 범위: settings:write, secrets:write. SMTP and e-mail templates을(를) 참조하세요.

Stripe 설정

Set up Stripe in test mode. My publishable key is pk_test_XXXX. Use the secret key and the
webhook secret from my Secret field (names stripe_secret_key and stripe_webhook_secret).
Then test the credentials and tell me which webhook URL I must add in Stripe.

payment_configure은(는) 항상 2단계 작업으로 진행됩니다. 시크릿 값이 마스킹된 미리보기를 확인하고 승인합니다. 그 후 payment_test을(를) 통해 Stripe 자격 증명을 확인합니다. 권한 범위: billing:write, secrets:write. 테스트 결제가 완료된 후에만 라이브 모드로 전환하세요. Stripe를 참조하세요.

텔레그램 알림 켜기

Add my Telegram chat 123456789 for admin alerts. The bot token is in my Secret field as
telegram_bot_token. Send a test message.

어시스턴트는 telegram_configure 및 telegram_test을(를) 호출합니다. 권한 범위: settings:write, secrets:write. Telegram notifications를 참조하세요.

고객 찾기 및 크레딧 추가

Find the customer with e-mail customer@example.com, show me their balance and servers,
and add $10.00 of credit because of the outage on Monday.

어시스턴트는 customers_search 및 customer_get(읽기 전용)을 호출한 다음, customer_adjust_balance을(를) delta_cents 1000 및 사유와 함께 호출합니다. 이는 항상 승인이 필요합니다. 확인 카드에는 "changes a customer balance"가 표시되며 감사 로그에 기록될 금액과 사유가 표시됩니다. 범위: admin:read, billing:write.

설정 내보내기

Export my whole configuration as YAML. Do not include secrets. Then tell me which settings
differ from a typical new installation.

어시스턴트는 config_export을(를) 호출합니다. 시크릿은 secret:// 참조로 대체됩니다. 결과를 nexcmp.yaml(으)로 저장하고 버전 제어 시스템에 보관하세요. Configuration as code을(를) 참조하세요. 권한 범위: admin:read.

효과적인 프롬프트 작성

• 목표와 사실(이름, 가격, 이메일 주소 등)을 제공하세요. 비밀 정보를 입력하지 마세요.
• 비용이 발생하거나 데이터가 삭제되는 작업은 먼저 미리보기를 요청하세요.
• 어시스턴트에게 "값을 변경하기 전에 현재 값을 읽어보라"고 요청하세요. 내장된 지침에 이미 포함되어 있습니다.
• 답변이 잘못되어 보인다면 "어떤 도구를 어떤 인자로 호출했나요?"라고 물어보세요. AI Chat의 도구 카드에서 둘 다 확인할 수 있습니다.

Troubleshooting

증상	원인	해결 방법
어시스턴트에 해당 도구가 없다고 나오는 경우	해당 도구의 권한이 부여되지 않았거나 AI의 작업이 차단된 경우	Admin API keys를 확인하거나 관리자 페이지에서 직접 수행하세요.
비밀번호를 입력하라고 요구하는 경우	모델이 지침을 무시한 경우	거부하고, Secret 필드를 사용하거나 관리자 페이지에서 직접 값을 입력하세요.
"실행(do it)" 후 아무것도 바뀌지 않는 경우	변경 사항이 확인을 대기 중인 경우	확인 카드로 스크롤하여 Confirm을 누르세요.
예상치 못한 가격으로 플랜이 생성된 경우	프롬프트에 입력된 비용이나 마진이 잘못된 경우	Plans 페이지에서 플랜을 수정하거나 어시스턴트에게 재가격을 요청하세요. 가격 변경 시 확인을 요청합니다.