# Edit Mode

The agents edit tab (AI->Agents) contains options for creating and editing agents for HyperSkill.&#x20;

<figure><img src="/files/3XJ1WEbflWjXFoaJRid2" alt=""><figcaption><p>The agents window when editing</p></figcaption></figure>

By default, the agent settings will be locked until you create or select an agent.

You can edit the following properties of agents:

<table><thead><tr><th>Property</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Name</td><td>The name of the agent.</td><td></td></tr><tr><td>When to run</td><td>Determines when the agent should generate a response. The options include "Run after user utterance", "Run through state machine", and "Run after character".</td><td></td></tr><tr><td>Use History</td><td>Determines if the agent should look at the last speech action or the entire conversational history. Generally the agent should look at the entire history.</td><td></td></tr><tr><td>Language Model</td><td>Determines which LLM to use. Azure refers to GPT4, Google refers to Google's Gemini Pro.</td><td></td></tr><tr><td>Instructions</td><td>The instructions the agent is intended to follow.</td><td></td></tr></tbody></table>

The options for "When to run" refer to the following:

<table><thead><tr><th>Option</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Run after user utterance</td><td>The agent will run after the user says or types something into HyperSkill every time. This is useful for evaluating the user at every dialogue turn.</td><td></td></tr><tr><td>Run through state machine</td><td>The agent will run only when the <a href="/pages/u8EAvLYUUPd7ZhCWDsp7">state action run agent</a> is used. This is useful to run the agent only when it is needed.</td><td></td></tr><tr><td>Run after character</td><td>The agent will run after the chit-chat roleplaying character finishes speaking. This is useful if you want to include the character response in an analysis.</td><td></td></tr></tbody></table>

When you click on the "+Add" button under "Describe Your Agent's Output", a new box will be added where you can describe what the agent should update in HyperSkill.

<figure><img src="/files/0IEgtNcdKfUT3e0l9YZy" alt=""><figcaption><p>An empty output box after clicking on the "+Add" button.</p></figcaption></figure>

We feed names and descriptions to a powerful language model, which then uses them to create new content that matches those descriptions. The created content can be automatically stored in a specific area ([attribute](/authoring-a-simulation/state-machine/scenario-flow/attributes.md)) for you to use easily. You can create as much outputs as you want, but access in HyperSkill might become restricted depending on your subscription plan and usage. You can edit the following fields:

<table><thead><tr><th>Property</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Name of Output</td><td>A descriptive name for the LLM to use.</td><td></td></tr><tr><td>Description of Output</td><td>This explains what kind of content the LLM should create. It could be something specific like "a score from 0-100" or more general like "feedback for the learner."</td><td></td></tr><tr><td>Output Destination</td><td>This tells the system where to put the generated content. It's like a specific label on a box where you want the information stored. These dropdowns point to a particular piece of data (<a href="/pages/sdLGCLYV4dA9DuTtlbzB">attribute</a>) for a virtual object.</td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.siminsights.com/ai/agents/edit-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
