Как написать хороший запрос
Что включить в запрос к Codexe — с удачными и неудачными примерами для плагинов, модов, датапаков, ботов и сайтов.
Обновлено
На этой странице
Запрос сильнее всего влияет на качество результата. AI может создать только то, что сумеет вывести из запроса, поэтому конкретные запросы выигрывают у длинных.
#Что указать
- Платформа и версия. «Paper 1.21.4», «Fabric для 1.20.1», «датапак для 1.21.1», «discord.py».
- Поведение. Что происходит, шаг за шагом, включая то, что должно случиться, если что-то пошло не так.
- Команды и аргументы.
/home <name>, кто может их выполнять и какие сообщения показываются. - Права. Названия узлов прав и значения по умолчанию.
- Конфигурация. Что владельцы серверов должны иметь возможность менять.
- Хранение данных. В памяти, в YAML-файле, SQLite или MySQL, и сохраняются ли данные после перезапуска.
- Интеграции. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Называйте их явно.
- Интерфейс. Сообщения в чате, GUI (меню на основе инвентаря), скорборды, боссбары.
- Крайние случаи. Игроки не в сети, полные инвентари, отключённые миры, перезагрузки.
#Плохо и лучше
Плохо: make a factions plugin
Лучше:
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
Лучше:
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
Лучше:
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
Лучше:
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 выбрать то, чем вы не сможете воспользоваться.