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
1
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.2
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.
3
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.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.Clique em Add Tools para navegar pelo catálogo: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.4
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.Próximas etapas
- Compartilhe o agente com sua equipe.
- Publique no marketplace quando o agente estiver estável.