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

# Geração de imagens

> Gere e edite imagens no ClickHouse Agents

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Funcionalidade Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

A geração de imagens permite que um agente crie novas imagens a partir de um prompt de texto ou edite imagens enviadas pelo usuário. O agente escolhe entre gerar e editar com base no que foi solicitado e no contexto disponível.

<div id="enable-it">
  ## Habilitar a geração de imagens
</div>

A geração de imagens é ativada por meio da janela modal **Add Tools** no Agent Builder (não na seção Capabilities). Clique em **Add Tools** na parte inferior do painel do Agent Builder e, em seguida, adicione uma das ferramentas de modelo de imagem — por exemplo, **OpenAI Image Tools**, **DALL-E-3** ou **Stable Diffusion**. O agente escolhe automaticamente a opção mais adequada com base na solicitação, ou você pode restringi-la nas instruções.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/tools-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=e98e46712afcbb5aa6347c8b7446ffd2" alt="Janela modal Agent Tools mostrando integrações de modelos de imagem, incluindo OpenAI Image Tools, DALL-E-3 e Stable Diffusion, ao lado de outras ferramentas de terceiros" size="md" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.webp" />

<div id="generation">
  ## Geração
</div>

Quando o usuário solicita uma imagem, o agente chama a ferramenta de geração com um prompt e retorna a imagem resultante embutida. O agente mantém uma referência à imagem em seu contexto para poder descrevê-la ou reutilizá-la na mesma conversa.

<div id="editing">
  ## Edição
</div>

Se o usuário enviar uma imagem e pedir uma modificação — mudar uma cor, adicionar um objeto, ampliar uma composição — o agente invoca a variante de edição da ferramenta. A saída substitui a região relevante ou estende a imagem original, conforme solicitado.

<div id="notes">
  ## Observações
</div>

* Imagens geradas não são enviadas automaticamente para uma análise separada com vision. Se você precisar que o agente *interprete* uma imagem, use [vision](/docs/pt-BR/products/cloud/features/ai-ml/agents/builder/vision) com uma imagem enviada pelo usuário.
* As políticas de conteúdo do provedor se aplicam. Prompts que violam a política do provedor retornam um erro em vez de uma imagem.