Help:Ephemera Agent: Difference between revisions
Import: Help:Ephemera Agent |
Add Maintenance Tools to navigation table |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
__TOC__ | __TOC__ | ||
'''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. | '''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) == | == Quick Start (5 minutes) == | ||
| Line 30: | Line 27: | ||
| [[Help:Ephemera Agent/Agent Interface]] || Running tasks, the agent log, example tasks | | [[Help:Ephemera Agent/Agent Interface]] || Running tasks, the agent log, example tasks | ||
|- | |- | ||
| [[Help:Ephemera Agent/Browser]] || Preview, Diff, Search | | [[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/Bulk Import]] || JSON and XML dump import | ||
| Line 36: | Line 39: | ||
| [[Help:Ephemera Agent/LLM Providers]] || Supported models, API keys, custom endpoints | | [[Help:Ephemera Agent/LLM Providers]] || Supported models, API keys, custom endpoints | ||
|- | |- | ||
| [[Help:Ephemera Agent/ | | [[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/ | | [[Help:Ephemera Agent/Maintenance Tools]] || Wiki Control Panel, deterministic query tools, maintenance.php API | ||
|} | |} | ||
== Safe Usage Guidelines == | == Safe Usage Guidelines == | ||
| Line 48: | Line 52: | ||
* Do not enable batch generation on a production wiki without supervision. | * Do not enable batch generation on a production wiki without supervision. | ||
* Use a dedicated bot account — never your main admin account. | * 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 == | == Common Issues == | ||
| Line 62: | Line 62: | ||
: Ensure an API key is loaded and the Generator model is selected. | : Ensure an API key is loaded and the Generator model is selected. | ||
; Context | ; Context tab is empty after an agent run | ||
: <code>agent.php</code> may not be | : <code>agent.php</code> may 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 <code>mediawiki-agent.html</code>. | |||
; Stub field does not auto-populate when browsing a stub | |||
: The page must be under 1,500 characters, or contain <code><nowiki>{{stub}}</nowiki></code>. Check the browser console for errors if neither condition populates the field. | |||
; XML import fails | ; XML import fails | ||
: Verify | : Verify the bot account has the <code>importupload</code> right and the permission is enabled in <code>LocalSettings.php</code>. | ||
== 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. | |||
[[Category:Help]] | [[Category:Help]] | ||
[[Category:EphemeraAgent]] | [[Category:EphemeraAgent]] | ||
Latest revision as of 02:41, 23 April 2026
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.