> For the complete documentation index, see [llms.txt](https://docs.zaia.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zaia.app/agents/agent-settings.md).

# Agent Settings

Agent Settings define the complete behavioral, cognitive, and operational configuration of an Agent.\
Each parameter directly affects how the Agent interprets inputs, reasons about context, and executes actions using connected MCPs, Tools, and Workflows.

This section details every configurable field available in the **Agent Builder** interface.

***

### Saving changes

Agent settings save automatically. There is no **Save** button.

When you edit a setting, Zaia saves the complete valid configuration in the background. This includes the Agent’s identity, instructions, model, and behavioral settings.

Text fields, such as **Role** and **Prompt**, save after 1.25 seconds without typing. Selectors, sliders, and switches save after 300 milliseconds.

The interface shows **Saving...** while a change is pending, saving, or retrying. You can keep editing during this time.

Zaia preserves newer edits when an earlier save finishes. If a save temporarily fails, it keeps your local changes and retries automatically.

You cannot leave the configuration screen while changes remain pending. This prevents unsaved settings from being lost.

#### Provider and model

**Provider** and **Model** are saved together. When you select another provider, Zaia refreshes the available models and selects the first compatible model when possible.

Zaia only saves the configuration after it has a valid provider and model selection.

Changing only the **Model** triggers the same automatic save flow. The new selection is persisted without changing the Agent's Prompt or other settings.

***

### Summary

| Section             | Description                                            |
| ------------------- | ------------------------------------------------------ |
| **Model Selection** | Defines the LLM provider and model used for reasoning. |
| **Role**            | Establishes the Agent’s identity and purpose.          |
| **Prompt**          | Configures tone, logic, and communication rules.       |
| **Temperature**     | Controls creativity vs. consistency.                   |
| **Effort**          | Determines reasoning depth and iteration count.        |
| **Planning**        | Enables task decomposition and multi-step execution.   |
| **Supervision**     | Allows iterative validation and self-correction.       |
| **Tasks**           | Adds conditional automated behaviors.                  |
| **Internal Chat**   | Interactive space for testing and fine-tuning.         |

Together, these settings define how each Agent **thinks, decides, and acts** inside the Endless ecosystem.