> ## Documentation Index
> Fetch the complete documentation index at: https://learn.diffusion.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat Box

> The chat box configures how your AI conversations work.

<div style={{ margin: "16px 0", borderRadius: 12, overflow: "hidden" }}>
  <img src="https://mintcdn.com/diffusionstudioinc/y163U1HfYM57SE_y/assets/chat-box/prompt_box.gif?s=29f0a3c25bda1c37291158fce1f77229" alt="Prompt box demo" style={{ width: "100%", height: "auto", display: "block" }} width="1280" height="720" data-path="assets/chat-box/prompt_box.gif" />
</div>

## Controls at a Glance

<CardGroup cols={2}>
  <Card title="Reasoning" icon="lightbulb">
    When enabled, the agent will create a step-by-step task list before acting on your request.
    After each step, it will decide what to do next. Recommended for complex, multi-step tasks.
    For simple tasks like generating an image, it's faster to keep this off.
  </Card>

  <Card title="Tool configuration" icon="sliders">
    The agent has access to 16+ tools. Here you can choose which tool it's allowed to use.
  </Card>

  <Card title="Aspect ratio" icon="crop">
    Set the aspect ratio for generated images and videos. Not all aspect ratios work with every tool - if
    your chosen, one isn't supported, the closest available option will be used.Set to `Auto` to let the system
    decide based on your prompt or chat context.
  </Card>

  <Card title="Video duration" icon="timer">
    Sets the length of generated videos.If your requested length isn't supported,it will use the
    nearest available option.
  </Card>

  <Card title="Audio" icon="music">
    When enabled, generated videos will include audio. This takes slightly longer than generating without audio.
  </Card>
</CardGroup>

> Not all aspect ratios or durations are available for every tool. If an option isn’t supported, the closest available option will be used automatically.

***

## Optimizing prompts

Within the Tool configuration, you'll also find a switch for `Prompt Optimization`.

<div style={{ margin: "16px 0", borderRadius: 12, overflow: "hidden" }}>
  <img src="https://mintcdn.com/diffusionstudioinc/y163U1HfYM57SE_y/assets/chat-box/prompt_optimization.gif?s=e2eb7b4776cf01f0cbe8e780e20694ce" alt="Prompt optimization demo" style={{ width: "100%", height: "auto", display: "block" }} width="1280" height="720" data-path="assets/chat-box/prompt_optimization.gif" />
</div>

When enabled, the agent uses an LLM to restructure your prompts so they work best with each tool. In other words, it automatically applies best practices for prompt writing.

> Tip: For high-fidelity prompting and precise prompt engineering, keep this disabled so your exact wording is preserved.

***

## Defining tool the access

At the bottom of the same dropdown, you'll see `Configure agent`.

<div style={{ margin: "16px 0", borderRadius: 12, overflow: "hidden" }}>
  <img src="https://mintcdn.com/diffusionstudioinc/y163U1HfYM57SE_y/assets/chat-box/configure_agent.gif?s=7779e0b85c9d14d7fdb5494bb9ea5f93" alt="Configure agent demo" style={{ width: "100%", height: "auto", display: "block" }} width="1280" height="720" data-path="assets/chat-box/configure_agent.gif" />
</div>

The agent can access multiple models for the each tool. E.g.
the tool "Text to image" might use `Flux.1 Kontext Max` or `GPT Image 1` .
Click on a model to select it, **double click to make it your primary selection**

> There’s no single “best” model — it depends on your style preferences, desired output speed, and budget. As a research company, we continuously monitor the generative space and make state-of-the-art models available whenever possible.

## Next Steps

<Steps>
  <Step title="Explore Examples">
    See end-to-end workflows.
    <Link href="examples/create-game-trailer">Create a Game Trailer</Link>
  </Step>
</Steps>
