Help:Ephemera Agent
Ephemera Agent is the AI-powered administration and content-generation tool for Encyclopedia Ephemera. It runs entirely in your browser and communicates with the wiki and AI providers through a small set of PHP proxy files hosted alongside the wiki.
Quick Start (5 minutes)
- Upload the server files to your wiki directory
- Create a bot password at Special:BotPasswords
- Open
mediawiki-agent.htmlin your browser - Log in with your bot credentials
- Load an API key or keys file
- Type a simple task and press RUN
You are now using the Ephemera Agent.
| Page | Contents |
|---|---|
| Help:Ephemera Agent/System Overview | Architecture, design principles, current status |
| Help:Ephemera Agent/Installation | Server setup, bot password, first login |
| Help:Ephemera Agent/Configuration | Keys file, Settings tab, Instructions:Config |
| Help:Ephemera Agent/Agent Interface | Running tasks, the agent log, example tasks |
| Help:Ephemera Agent/Browser | Preview, Diff, Search, Red Link AutoGen, Source routing, + CONTEXT button |
| Help:Ephemera Agent/Context Tab | Context inspector, stub field, POST and EXPAND buttons, custom pages |
| Help:Ephemera Agent/Stub Workflow | Full stub → expand lifecycle; batch stubs; source routing |
| Help:Ephemera Agent/Context Assembly | How context is gathered; task types; task_type_override; custom_pages |
| Help:Ephemera Agent/Bulk Import | JSON and XML dump import |
| Help:Ephemera Agent/LLM Providers | Supported models, API keys, custom endpoints |
| Help:Ephemera Agent/Instruction Namespace | Writing and organising Instructions: pages |
| Help:Ephemera Agent/Logging & Training Data | Agent call logging, DB schema, training data pipeline |
| Help:Ephemera Agent/Maintenance Tools | Wiki Control Panel, deterministic query tools, maintenance.php API |
Safe Usage Guidelines
- This tool can create and overwrite pages rapidly.
- Always review diffs before trusting generated content.
- Do not enable batch generation on a production wiki without supervision.
- Use a dedicated bot account — never your main admin account.
- In stub mode, batch generation posts many new pages in quick succession. Review them before expanding.
Common Issues
- Login fails
- Check bot username format:
User@BotName
- No pages are generated
- Ensure an API key is loaded and the Generator model is selected.
- Context tab is empty after an agent run
agent.phpmay not be reachable, or the task was routed through the direct (no-context) path (e.g. classified as a simple query).
- Batch stub generates a page called "source" instead of a source document
- This was a display-text vs. target-title bug fixed 2026-04-09. Ensure you are running the current version of
mediawiki-agent.html.
- Stub field does not auto-populate when browsing a stub
- The page must be under 1,500 characters, or contain
{{stub}}. Check the browser console for errors if neither condition populates the field.
- XML import fails
- Verify the bot account has the
importuploadright and the permission is enabled inLocalSettings.php.
About This Tool
Ephemera Agent was built collaboratively using Claude (Anthropic) and GPT (OpenAI). It is an alpha release. All core features are functional but the system has not been hardened for multi-user or public deployment.