본문으로 건너뛰기
시작하기

좋은 요청을 작성하는 방법

Codexe 요청에 무엇을 넣어야 하는지, 플러그인, 모드, 데이터팩, 봇, 웹사이트의 좋은 예와 나쁜 예로 알아봐요.

업데이트됨

이 페이지에서
  1. 넣어야 할 내용
  2. 나쁜 예와 더 나은 예
  3. 큰 프로젝트는 단계별로 만들기
  4. 프롬프트 개선
  5. 원하지 않는 것도 적기

요청은 결과물의 품질을 좌우하는 가장 큰 요소예요. AI는 추론할 수 있는 것만 만들 수 있으니, 긴 요청보다 구체적인 요청이 더 좋은 결과를 내요.

#넣어야 할 내용

  • 플랫폼과 버전. "Paper 1.21.4", "1.20.1용 Fabric", "1.21.1용 데이터팩", "discord.py".
  • 동작. 무슨 일이 일어나는지 단계별로, 문제가 생겼을 때 어떻게 되는지까지 적어요.
  • 명령어와 인수. /home <name>, 누가 실행할 수 있는지, 어떤 메시지가 표시되는지 적어요.
  • 권한. 노드 이름과 기본값을 적어요.
  • 설정. 서버 운영자가 무엇을 바꿀 수 있어야 하는지 적어요.
  • 저장 방식. 메모리, YAML 파일, SQLite, MySQL 중 무엇인지, 재시작 후에도 남아야 하는지 적어요.
  • 연동. Vault, PlaceholderAPI, LuckPerms, WorldGuard. 이름을 분명하게 적어요.
  • UI. 채팅 메시지, GUI(인벤토리 메뉴), 스코어보드, 보스 바.
  • 예외 상황. 오프라인 플레이어, 가득 찬 인벤토리, 비활성화된 월드, 리로드.

#나쁜 예와 더 나은 예

나쁜 예: make a factions plugin

더 나은 예:

Text
A Paper 1.21.x factions plugin.
- /f create <name>, /f invite <player>, /f join <name>, /f leave, /f disband (owner only).
- Max 10 members per faction (configurable).
- Chunk claiming with /f claim and /f unclaim; claimed chunks block building by non-members.
- Faction power: +1 per online member, claims limited to power x 2.
- Data saved to SQLite, loaded on startup.
- Vault economy: creating a faction costs 1000 (configurable).
- Permissions: factions.use (default true), factions.admin (op) for /f admin bypass.

나쁜 예: a mod with new swords

더 나은 예:

Text
A Fabric mod for Minecraft 1.20.1.
- Adds three swords: Ember Blade (sets targets on fire for 3s), Frost Edge (Slowness II for 2s), Void Cutter (5% chance to teleport the target 8 blocks).
- Crafting recipes using blaze rods, packed ice and ender pearls with a netherite sword.
- English lang file and item models (textures can be placeholders).
- No client-only code on the server side.

나쁜 예: custom recipes

더 나은 예:

Text
A datapack for Minecraft 1.21.1.
- Shaped recipe: 8 rotten flesh around a leather = 1 leather.
- Shapeless recipe: 9 nether wart = 1 nether wart block, and the reverse.
- A function that runs every tick and gives Speed I to players standing on gold blocks.

나쁜 예: moderation bot

더 나은 예:

Text
A discord.py bot with slash commands.
- /warn <user> <reason>: stores warnings in SQLite, DMs the user.
- /warnings <user>: lists warnings with dates.
- /timeout <user> <minutes> <reason>: applies a Discord timeout; only for members with Moderate Members.
- Logs every action to a channel set with /setlog.
- Token read from an environment variable.

#큰 프로젝트는 단계별로 만들기

기능이 쉰 개나 되는 명세를 한 번의 요청에 붙여 넣지 마세요. 핵심(데이터 모델, 주요 명령어)부터 시작해 Codexe가 검증하게 한 다음, 후속 메시지로 기능을 추가하세요. 단계마다 작고, 저렴하고, 검증되고, 고치기도 쉬워져요.

#프롬프트 개선

만들기(프로젝트 만들기)에 있는 프롬프트 개선 버튼은 대략적인 요청을 더 완성도 있는 요청으로 다시 써 줘요. 비용은 5,000 토큰 고정이에요. 생성하기 전에 개선된 텍스트를 꼭 읽어 보세요. 원하지 않는 세부 사항을 가정했을 수도 있어요.

#원하지 않는 것도 적기

"데이터베이스 없이 모두 config.yml에 저장", "NMS 사용 금지", "외부 의존성 없음". 이런 제약을 적어 두면 AI가 여러분이 쓸 수 없는 방식을 고르지 않아요.

좋은 요청을 작성하는 방법 | Codexe Docs