Перейти к основному содержанию
Перейти к основному содержанию

Как создать агента SlackBot с помощью ClickHouse MCP Server

В этом руководстве вы узнаете, как создать агента SlackBot. Этот бот позволяет задавать вопросы о ваших данных в ClickHouse прямо из Slack, используя естественный язык. Он использует ClickHouse MCP Server и PydanticAI.

Пример проекта

Код этого примера доступен в репозитории с примерами.

Предварительные требования​

  • Необходимо установить uv
  • Необходим доступ к рабочему пространству Slack
  • Необходим API-ключ Anthropic или API-ключ от другого провайдера LLM

Создайте приложение Slack​

  1. Перейдите на slack.com/apps и нажмите Create New App.
  2. Выберите вариант From scratch и задайте имя приложению.
  3. Выберите рабочее пространство Slack.

Установите приложение в рабочее пространство​

Далее добавьте созданное на предыдущем шаге приложение в рабочее пространство. Следуйте инструкциям из раздела "Добавление приложений в рабочее пространство Slack" в документации Slack.

Настройка параметров приложения Slack​

  • Перейдите в App Home
    • В разделе Show Tabs → Messages Tab включите Allow users to send Slash commands and messages from the messages tab
    • Перейдите в Socket Mode
      • Включите Socket Mode
      • Сохраните значение Socket Mode Handler для переменной окружения SLACK_APP_TOKEN
    • Перейдите в OAuth & Permissions
      • Добавьте следующие Bot Token Scopes:
        • app_mentions:read
        • assistant:write
        • chat:write
        • im:history
        • im:read
        • im:write
        • channels:history
      • Установите приложение в рабочее пространство и сохраните Bot User OAuth Token для переменной окружения SLACK_BOT_TOKEN.
    • Перейдите в Event Subscriptions
      • Включите Events
      • В разделе Subscribe to bot events добавьте:
        • app_mention
        • assistant_thread_started
        • message:im
      • Сохраните изменения.

Добавьте переменные окружения (.env)​

Создайте файл .env в корне проекта со следующими переменными окружения, чтобы ваше приложение могло подключаться к SQL-песочнице ClickHouse.

SLACK_BOT_TOKEN=your-slack-bot-token
SLACK_APP_TOKEN=your-slack-app-level-token
ANTHROPIC_API_KEY=your-anthropic-api-key
CLICKHOUSE_HOST=sql-clickhouse.clickhouse.com
CLICKHOUSE_PORT=8443
CLICKHOUSE_USER=demo
CLICKHOUSE_PASSWORD=
CLICKHOUSE_SECURE=true

Вы можете настроить переменные ClickHouse для использования собственного сервера ClickHouse или облачного экземпляра, если хотите.

Использование бота​

  1. Запустите бота:

    uv run main.py

  2. В Slack:

    • Упомяните бота в канале: @yourbot Who are the top contributors to the ClickHouse git repo?
    • Ответьте в ветке с упоминанием: @yourbot how many contributions did these users make last week?
    • Напишите боту в личные сообщения: Show me all tables in the demo database.

Бот ответит в ветке, используя все предыдущие сообщения ветки в качестве контекста, если это применимо.

Контекст ветки: При ответе в ветке бот загружает все предыдущие сообщения (кроме текущего) и включает их в качестве контекста для AI.

Использование инструментов: Бот использует только инструменты, доступные через MCP (например, обнаружение схемы, выполнение SQL), и всегда показывает использованный SQL и краткое описание того, как был получен ответ.