> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido

> Crie e execute seu primeiro ClickHouse Agent em um serviço do ClickHouse Cloud

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 galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

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/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

Crie um agente personalizado no Cloud Console e execute uma consulta em linguagem natural no seu serviço.

<div id="prerequisites">
  ## Pré-requisitos
</div>

* Um serviço do ClickHouse Cloud que você possa consultar.
* A opção **Criar agente** no Agent Builder. Se ela não aparecer, peça a um administrador da organização para conceder permissão para criar agentes em Configurações do Admin, conforme detalhado em [compartilhamento e acesso](/pt-BR/products/cloud/features/ai-ml/agents/sharing-and-access).

<div id="build-the-agent">
  ## Crie o agente
</div>

<Steps>
  <Step>
    ### Inicie o ClickHouse Agents

    No seu serviço Cloud, clique em **ClickHouse agents** na barra lateral esquerda para abrir a central dos agentes. Clique em **Launch ClickHouse agents** para abrir o Agent Builder.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/ie2pnLZPTjmhniJm/images/cloud/agent-builder/launch-ch-agents.webp?fit=max&auto=format&n=ie2pnLZPTjmhniJm&q=85&s=b20cb0d5843ecccd828953243bd309bb" alt="Navegação do serviço Cloud com ClickHouse agents (Beta) selecionado, mostrando a central dos agentes com o botão Launch ClickHouse agents" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.webp" />
  </Step>

  <Step>
    ### Crie o agente

    No Agent Builder, clique em **Create New Agent** na parte superior do painel esquerdo. Preencha os campos principais:

    * **Name** - um identificador curto para o seu agente.
    * **Description** - uma descrição da finalidade do agente, que ficará visível para os colegas da equipe.
    * **Category** - uma categoria para o seu agente. Você pode deixar como `General`, a menos que sua organização tenha categorias personalizadas.
    * **Instructions** - o system prompt, que descreve a função do agente, as perguntas que ele deve responder e quaisquer regras de negócio que precise seguir.
    * **Model** - escolha um modelo na lista suspensa.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/ie2pnLZPTjmhniJm/images/cloud/agent-builder/agent-builder.webp?fit=max&auto=format&n=ie2pnLZPTjmhniJm&q=85&s=2c12037075c343e5ab59d89ed5d808b1" alt="Painel do Agent Builder mostrando o menu suspenso Create New Agent, os campos do formulário (Name, Description, Category, Instructions, Model) e a seção Capabilities" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.webp" />
  </Step>

  <Step>
    ### Adicione recursos e ferramentas

    Os recursos e as ferramentas do agente ficam em dois lugares.

    **Capabilities** no painel principal — recursos nativos como [Run Code](/pt-BR/products/cloud/features/ai-ml/agents/builder/code-interpreter), [Web Search](/pt-BR/products/cloud/features/ai-ml/agents/builder/web-search), File Context, Artifacts, [MCP Servers](/pt-BR/products/cloud/features/ai-ml/agents/builder/mcp-servers) e [Skills](/pt-BR/products/cloud/features/ai-ml/agents/builder/skills). Ative os que o agente precisar.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/ie2pnLZPTjmhniJm/images/cloud/agent-builder/capabilities.webp?fit=max&auto=format&n=ie2pnLZPTjmhniJm&q=85&s=707cb11c0ceb836f6df96104a26804ea" alt="Seção Capabilities do painel do Agent Builder mostrando os controles de Run Code, Web Search, File Context, Artifacts, MCP Servers e Skills" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.webp" />

    **Tools** no botão **Add Tools** na parte inferior do painel — integrações de terceiros como [image generation](/pt-BR/products/cloud/features/ai-ml/agents/builder/image-generation), [vision](/pt-BR/products/cloud/features/ai-ml/agents/builder/vision), APIs de busca e serviços externos.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/ie2pnLZPTjmhniJm/images/cloud/agent-builder/tools-button.webp?fit=max&auto=format&n=ie2pnLZPTjmhniJm&q=85&s=cf92bcc968fc70938a66dbb51c15affc" alt="Parte inferior do painel do Agent Builder com o botão Add Tools destacado" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.webp" />

    Clique em **Add Tools** para navegar pelo catálogo:

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/ie2pnLZPTjmhniJm/images/cloud/agent-builder/tools-modal.webp?fit=max&auto=format&n=ie2pnLZPTjmhniJm&q=85&s=e4285824e486a3346b2e599e0d30b1d4" alt="Modal Agent Tools mostrando uma grade de integrações de terceiros, incluindo Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator e Stable Diffusion" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.webp" />

    [Subagents](/pt-BR/products/cloud/features/ai-ml/agents/builder/subagents) são configurados em **Advanced settings** — consulte a página de Subagents para mais detalhes.

    Você pode alterar os recursos e as ferramentas adicionados a qualquer momento.
  </Step>

  <Step>
    ### Execute uma consulta

    Salve o agente, abra uma nova conversa e selecione seu agente no seletor de agentes. Digite uma pergunta — por exemplo, *"Quais são minhas 10 principais tabelas por contagem de linhas nesta semana?"* — e o agente planeja, chama ferramentas conforme necessário e retorna uma resposta.

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/ie2pnLZPTjmhniJm/images/cloud/agent-builder/chat-query.webp?fit=max&auto=format&n=ie2pnLZPTjmhniJm&q=85&s=12139fc26a6ac7e39221895aad038871" alt="Conversa no chat mostrando a pergunta 'What are my top 10 tables by row count this week?' e a resposta do agente — uma tabela em Markdown classificando as 10 principais tabelas entre os serviços por contagem de linhas, com Key Observations abaixo" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.webp" />
  </Step>
</Steps>

<div id="next-steps">
  ## Próximas etapas
</div>

* [Compartilhe o agente](/pt-BR/products/cloud/features/ai-ml/agents/sharing-and-access) com sua equipe.
* Publique no [marketplace](/pt-BR/products/cloud/features/ai-ml/agents/marketplace) quando o agente estiver estável.