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

# Using entities in generations

> Reference characters, props, environments, styles, and scenes in Agent and supported model prompts.

## In fal Agent

Type `@` in the composer to search for a saved entity. Select a character, prop, environment, style, or scene. Describe what you want to make with those references:

```text theme={null}
Create a product hero shot of @green-bottle in @workshop.
Use @watercolor as the visual style.
```

The agent receives the selected entities as context for the generation. Be explicit about the role each must play, especially when combining a character, prop, environment, and style.

You can also create an entity from reference images as part of an Agent workflow. See [Assets in Agent](/docs/documentation/agent/assets-and-characters).

## In Sandbox and supported model prompts

In Sandbox and supported model prompts, type `@` to search characters, props, environments, styles, and scenes. Select the entity, then review the model's inputs before generating.

How the reference is used depends on the model:

* A model with a supported image-reference input can receive reference images.
* A text-only model can use an entity's description in the prompt, but cannot receive its reference images.
* An entity without a description cannot be used on a text-only model through this flow. The form blocks an unsupported run.

The number of images a model accepts can be lower than the entity's twenty-reference limit. Select a model appropriate for the edit or reference task rather than assuming every model uses every reference.

## Reference images and gallery links

Only the entity's defining references establish its reference set. Manually linking a new output to the entity's gallery does not automatically add it to the reference images. Edit the entity to make that change.

## Find the results

Open the entity's page to browse associated media, or inspect a result's [generation details](/docs/documentation/assets/library/history).

See [Searching and filtering](/docs/documentation/assets/library/search) for finding library media and saved entities.