Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Início rápido

View as MarkdownEdit this pageReport an issueSet up docs MCP
Recurso beta

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

Pré-requisitos

  • 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.

Crie o agente

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.

Navegação do serviço Cloud com ClickHouse agents (Beta) selecionado, mostrando a central dos agentes com o botão Launch ClickHouse agents

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.
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

Adicione recursos e ferramentas

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

Capabilities no painel principal — recursos nativos como Run Code, Web Search, File Context, Artifacts, MCP Servers e Skills. Ative os que o agente precisar.

Seção Capabilities do painel do Agent Builder mostrando os controles de Run Code, Web Search, File Context, Artifacts, MCP Servers e Skills

Tools no botão Add Tools na parte inferior do painel — integrações de terceiros como image generation, vision, APIs de busca e serviços externos.

Parte inferior do painel do Agent Builder com o botão Add Tools destacado

Clique em Add Tools para navegar pelo catálogo:

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

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.

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.

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

Próximos passos

Navigation