Skip to main content
Neste guia, você aprenderá a criar um agente de IA com o framework Microsoft Agent que pode interagir com o playground SQL do ClickHouse usando o servidor MCP do ClickHouse.
Notebook de exemploEste exemplo está disponível como um notebook no repositório de exemplos.

Pré-requisitos

  • Você precisará ter o Python instalado no seu sistema.
  • Você precisará ter o pip instalado no seu sistema.
  • Você precisará de uma API key da OpenAI
Você pode executar as etapas a seguir no REPL do Python ou por meio de um script.
1

Instalar bibliotecas

Instale a biblioteca do framework Microsoft Agent executando os comandos a seguir:
2

Configurar credenciais

Em seguida, você precisará fornecer sua chave de API da OpenAI:
Response
Em seguida, defina as credenciais necessárias para se conectar ao playground do ClickHouse SQL:
3

Inicialize o ClickHouse MCP server e o agente do framework Microsoft Agent

Agora configure o ClickHouse MCP server para apontar para o Playground do ClickHouse SQL e também inicialize nosso agente e faça uma pergunta a ele:
A saída da execução deste script é mostrada abaixo:
Response
Última modificação em 23 de julho de 2026