Agent
Open Configs → Agent to create and edit agent configurations. A config combines a base agent with your game’s instructions, hints, knowledge files, and credential kinds. Select it in the test editor to reuse that setup across tests.
Creating and editing configs requires the project:edit-configs permission.
Base Agents
Every agent config requires a base agent: the underlying agent configuration that provides its capabilities and runtime settings. Choose a base, then enhance it with your game’s context, hints, attached files, and credentials.
| Base agent | Best for |
|---|---|
| nunu-mini | Simpler tasks at significantly lower cost. |
| nunu-default | Most tasks, with the best balance of capability, performance, and cost. |
| nunu-max | Complex tasks and 3D scenarios that require advanced reasoning, at higher cost. |
In the base agent selector, latest follows new releases automatically. Select a specific version to pin your config to that release.
Basic Configuration
| Setting | Use |
|---|---|
| game configuration | Describe your game and the rules the agent should follow across tests using this config. Keep the guidance concise; attach detailed reference material as knowledge files. |
| environment timing | Set the minimum time between actions in milliseconds. Use enough time for the application to respond and animations to settle. |
Knowledge Files
Save the config, then open its Knowledge tab to attach files. Drag a file into the upload area or click to upload. Use new file to write or paste a text or data file directly in Nexus.
These files are available whenever a test uses this agent config. Use them for control mappings, game mechanics, setup guides, or reference material for the agent’s testing focus. Add a description explaining when the agent should read each file.
For supported formats, limits, and other scopes, see Knowledge Base.
Credentials
When Credentials is enabled, open the Credentials tab and select the credential kinds the agent needs. Set the count for each selected kind, then save the config with Create or Update.
Create kinds and their entries in Configs → Credentials. Reference the kind by name in your test instructions, for example: Use game-account to log in. Credentials attached to the config are available to tests that use it; you can also attach credentials to an individual test.
Hint Manual
Use Hint Manual for guidance that applies across tests using this config. Click + add hint and write an action the agent can follow, such as:
- If a news popup covers the menu, close it before continuing.
- Open the forge by selecting the building with the hammer icon.
Put guidance for a particular test or verification step in that test’s hints. See Put Guidance in the Right Place for choosing between instructions, checks, hints, and knowledge.