feat: add WebChat adapter for pipeline debugging (#1510)

* feat: add WebChat adapter for pipeline debugging - Create WebChatAdapter for handling debug messages in pipeline testing - Add HTTP API endpoints for debug message sending and retrieval - Implement frontend debug dialog with session switching (private/group chat) - Add Chinese i18n translations for debug interface - Auto-create default WebChat bot during database initialization - Support fixed session IDs: webchatperson and webchatgroup for testing Co-Authored-By: Junyan Qin <Chin>, 秦骏言 in Chinese, you can call me my english name Rock Chin. <rockchinq@gmail.com> * perf: ui for webchat * feat: complete webchat backend * feat: core chat apis * perf: button style in pipeline card * perf: log btn in bot card * perf: webchat entities definition * fix: bugs * perf: web chat * perf: dialog styles * perf: styles * perf: styles * fix: group invalid in webchat * perf: simulate real im message * perf: group timeout toast * feat(webchat): add supports for mentioning bot in group * perf(webchat): at component styles * perf: at badge display in message * fix: linter errors * fix: webchat was listed on adapter list --------- Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: Junyan Qin <Chin>, 秦骏言 in Chinese, you can call me my english name Rock Chin. <rockchinq@gmail.com>
2026-06-05 05:16:03 +00:00 · 2025-06-08 15:34:26 +08:00
parent e6bc009414
commit 4f2ec195fc
25 changed files with 1358 additions and 25 deletions
--- a/web/src/app/home/bots/components/bot-card/BotCard.tsx
+++ b/web/src/app/home/bots/components/bot-card/BotCard.tsx
@@ -4,6 +4,7 @@ import { httpClient } from '@/app/infra/http/HttpClient';
 import { Switch } from '@/components/ui/switch';
 import { useTranslation } from 'react-i18next';
 import { toast } from 'sonner';
+import { Button } from '@/components/ui/button';

 export default function BotCard({
  botCardVO,
@@ -92,25 +93,25 @@ export default function BotCard({
              e.stopPropagation();
            }}
          />
-          <div
-            className={`${styles.botLogsIcon}`}
+          <Button
+            size="icon"
+            variant="outline"
+            className="w-[40px] h-[40px]"
            onClick={(e) => {
              onClickLogIcon();
              e.stopPropagation();
            }}
          >
            <svg
-              viewBox="0 0 24 24"
-              fill="none"
              xmlns="http://www.w3.org/2000/svg"
-              className="w-[24px] h-[24px] z-10"
+              viewBox="0 0 24 24"
+              width="48"
+              height="48"
+              fill="currentColor"
            >
-              <path
-                d="M21 8V20.9932C21 21.5501 20.5552 22 20.0066 22H3.9934C3.44495 22 3 21.556 3 21.0082V2.9918C3 2.45531 3.4487 2 4.00221 2H14.9968L21 8ZM19 9H14V4H5V20H19V9ZM8 7H11V9H8V7ZM8 11H16V13H8V11ZM8 15H16V17H8V15Z"
-                fill="#9A9A9A"
-              />
+              <path d="M21 8V20.9932C21 21.5501 20.5552 22 20.0066 22H3.9934C3.44495 22 3 21.556 3 21.0082V2.9918C3 2.45531 3.4487 2 4.00221 2H14.9968L21 8ZM19 9H14V4H5V20H19V9ZM8 7H11V9H8V7ZM8 11H16V13H8V11ZM8 15H16V17H8V15Z"></path>
            </svg>
-          </div>
+          </Button>
        </div>
      </div>
    </div>
--- a/web/src/app/home/pipelines/components/pipeline-card/PipelineCard.tsx
+++ b/web/src/app/home/pipelines/components/pipeline-card/PipelineCard.tsx
@@ -1,9 +1,22 @@
 import styles from './pipelineCard.module.css';
 import { PipelineCardVO } from '@/app/home/pipelines/components/pipeline-card/PipelineCardVO';
 import { useTranslation } from 'react-i18next';
+import { Button } from '@/components/ui/button';

-export default function PipelineCard({ cardVO }: { cardVO: PipelineCardVO }) {
+export default function PipelineCard({
+  cardVO,
+  onDebug,
+}: {
+  cardVO: PipelineCardVO;
+  onDebug: (pipelineId: string) => void;
+}) {
  const { t } = useTranslation();
+
+  const handleDebugClick = (e: React.MouseEvent) => {
+    e.stopPropagation();
+    onDebug(cardVO.id);
+  };
+
  return (
    <div className={`${styles.cardContainer}`}>
      <div className={`${styles.basicInfoContainer}`}>
@@ -48,6 +61,22 @@ export default function PipelineCard({ cardVO }: { cardVO: PipelineCardVO }) {
            </div>
          </div>
        )}
+        <Button
+          variant="outline"
+          onClick={handleDebugClick}
+          title={t('pipelines.chat')}
+          className="mt-auto"
+        >
+          <svg
+            xmlns="http://www.w3.org/2000/svg"
+            viewBox="0 0 24 24"
+            fill="currentColor"
+            className={styles.debugButtonIcon}
+          >
+            <path d="M13 19.9C15.2822 19.4367 17 17.419 17 15V12C17 11.299 16.8564 10.6219 16.5846 10H7.41538C7.14358 10.6219 7 11.299 7 12V15C7 17.419 8.71776 19.4367 11 19.9V14H13V19.9ZM5.5358 17.6907C5.19061 16.8623 5 15.9534 5 15H2V13H5V12C5 11.3573 5.08661 10.7348 5.2488 10.1436L3.0359 8.86602L4.0359 7.13397L6.05636 8.30049C6.11995 8.19854 6.18609 8.09835 6.25469 8H17.7453C17.8139 8.09835 17.88 8.19854 17.9436 8.30049L19.9641 7.13397L20.9641 8.86602L18.7512 10.1436C18.9134 10.7348 19 11.3573 19 12V13H22V15H19C19 15.9534 18.8094 16.8623 18.4642 17.6907L20.9641 19.134L19.9641 20.866L17.4383 19.4077C16.1549 20.9893 14.1955 22 12 22C9.80453 22 7.84512 20.9893 6.56171 19.4077L4.0359 20.866L3.0359 19.134L5.5358 17.6907ZM8 6C8 3.79086 9.79086 2 12 2C14.2091 2 16 3.79086 16 6H8Z"></path>
+          </svg>
+          {t('pipelines.chat')}
+        </Button>
      </div>
    </div>
  );
--- a/web/src/app/home/pipelines/components/pipeline-card/pipelineCard.module.css
+++ b/web/src/app/home/pipelines/components/pipeline-card/pipelineCard.module.css
@@ -67,9 +67,11 @@

 .operationContainer {
  display: flex;
-  flex-direction: row;
+  flex-direction: column;
+  align-items: flex-end;
+  justify-content: space-between;
  gap: 0.5rem;
-  width: 5rem;
+  width: 8rem;
 }

 .operationDefaultBadge {
@@ -98,3 +100,8 @@
  font-weight: bold;
  max-width: 100%;
 }
+
+.debugButtonIcon {
+  width: 1.2rem;
+  height: 1.2rem;
+}
--- a/web/src/app/home/pipelines/debug-dialog/AtBadge.tsx
+++ b/web/src/app/home/pipelines/debug-dialog/AtBadge.tsx
@@ -0,0 +1,31 @@
+import { Badge } from '@/components/ui/badge';
+import { X } from 'lucide-react';
+
+interface AtBadgeProps {
+  targetName: string;
+  readonly?: boolean;
+  onRemove?: () => void;
+}
+
+export default function AtBadge({
+  targetName,
+  readonly = false,
+  onRemove,
+}: AtBadgeProps) {
+  return (
+    <Badge
+      variant="secondary"
+      className="flex items-center gap-1 px-2 py-1 text-sm bg-blue-100 text-blue-600 hover:bg-blue-200"
+    >
+      @{targetName}
+      {!readonly && onRemove && (
+        <button
+          onClick={onRemove}
+          className="ml-1 hover:text-blue-800 focus:outline-none"
+        >
+          <X className="h-3 w-3" />
+        </button>
+      )}
+    </Badge>
+  );
+}
--- a/web/src/app/home/pipelines/debug-dialog/DebugDialog.tsx
+++ b/web/src/app/home/pipelines/debug-dialog/DebugDialog.tsx
@@ -0,0 +1,422 @@
+import React, { useState, useEffect, useRef } from 'react';
+import { useTranslation } from 'react-i18next';
+import { httpClient } from '@/app/infra/http/HttpClient';
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+} from '@/components/ui/dialog';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '@/components/ui/select';
+import { ScrollArea } from '@/components/ui/scroll-area';
+import { cn } from '@/lib/utils';
+import { Pipeline } from '@/app/infra/entities/api';
+import { Message } from '@/app/infra/entities/message';
+import { toast } from 'sonner';
+import AtBadge from './AtBadge';
+
+interface MessageComponent {
+  type: 'At' | 'Plain';
+  target?: string;
+  text?: string;
+}
+
+interface DebugDialogProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  pipelineId: string;
+}
+
+export default function DebugDialog({
+  open,
+  onOpenChange,
+  pipelineId,
+}: DebugDialogProps) {
+  const { t } = useTranslation();
+  const [selectedPipelineId, setSelectedPipelineId] = useState(pipelineId);
+  const [sessionType, setSessionType] = useState<'person' | 'group'>('person');
+  const [messages, setMessages] = useState<Message[]>([]);
+  const [inputValue, setInputValue] = useState('');
+  const [pipelines, setPipelines] = useState<Pipeline[]>([]);
+  const [showAtPopover, setShowAtPopover] = useState(false);
+  const [hasAt, setHasAt] = useState(false);
+  const [isHovering, setIsHovering] = useState(false);
+  const messagesEndRef = useRef<HTMLDivElement>(null);
+  const inputRef = useRef<HTMLInputElement>(null);
+  const popoverRef = useRef<HTMLDivElement>(null);
+
+  const scrollToBottom = () => {
+    messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+  };
+
+  useEffect(() => {
+    scrollToBottom();
+  }, [messages]);
+
+  useEffect(() => {
+    if (open) {
+      setSelectedPipelineId(pipelineId);
+      loadPipelines();
+      loadMessages(pipelineId);
+    }
+  }, [open, pipelineId]);
+
+  useEffect(() => {
+    if (open) {
+      loadMessages(selectedPipelineId);
+    }
+  }, [sessionType, selectedPipelineId]);
+
+  useEffect(() => {
+    const handleClickOutside = (event: MouseEvent) => {
+      if (
+        popoverRef.current &&
+        !popoverRef.current.contains(event.target as Node) &&
+        !inputRef.current?.contains(event.target as Node)
+      ) {
+        setShowAtPopover(false);
+      }
+    };
+
+    document.addEventListener('mousedown', handleClickOutside);
+    return () => {
+      document.removeEventListener('mousedown', handleClickOutside);
+    };
+  }, []);
+
+  useEffect(() => {
+    if (showAtPopover) {
+      setIsHovering(true);
+    }
+  }, [showAtPopover]);
+
+  const loadPipelines = async () => {
+    try {
+      const response = await httpClient.getPipelines();
+      setPipelines(response.pipelines);
+    } catch (error) {
+      console.error('Failed to load pipelines:', error);
+    }
+  };
+
+  const loadMessages = async (pipelineId: string) => {
+    try {
+      const response = await httpClient.getWebChatHistoryMessages(
+        pipelineId,
+        sessionType,
+      );
+      setMessages(response.messages);
+    } catch (error) {
+      console.error('Failed to load messages:', error);
+    }
+  };
+
+  const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const value = e.target.value;
+    if (sessionType === 'group') {
+      if (value.endsWith('@')) {
+        setShowAtPopover(true);
+      } else if (showAtPopover && (!value.includes('@') || value.length > 1)) {
+        setShowAtPopover(false);
+      }
+    }
+    setInputValue(value);
+  };
+
+  const handleAtSelect = () => {
+    setHasAt(true);
+    setShowAtPopover(false);
+    setInputValue(inputValue.slice(0, -1));
+  };
+
+  const handleAtRemove = () => {
+    setHasAt(false);
+  };
+
+  const handleKeyPress = (e: React.KeyboardEvent) => {
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault();
+      if (showAtPopover) {
+        handleAtSelect();
+      } else {
+        sendMessage();
+      }
+    } else if (e.key === 'Backspace' && hasAt && inputValue === '') {
+      handleAtRemove();
+    }
+  };
+
+  const sendMessage = async () => {
+    if (!inputValue.trim() && !hasAt) return;
+
+    try {
+      const messageChain = [];
+
+      let text_content = inputValue.trim();
+      if (hasAt) {
+        text_content = ' ' + text_content;
+      }
+
+      if (hasAt) {
+        messageChain.push({
+          type: 'At',
+          target: 'webchatbot',
+        });
+      }
+      messageChain.push({
+        type: 'Plain',
+        text: text_content,
+      });
+
+      if (hasAt) {
+        // for showing
+        text_content = '@webchatbot' + text_content;
+      }
+
+      const userMessage: Message = {
+        id: -1,
+        role: 'user',
+        content: text_content,
+        timestamp: new Date().toISOString(),
+        message_chain: messageChain,
+      };
+
+      setMessages((prevMessages) => [...prevMessages, userMessage]);
+      setInputValue('');
+      setHasAt(false);
+
+      const response = await httpClient.sendWebChatMessage(
+        sessionType,
+        messageChain,
+        selectedPipelineId,
+        120000,
+      );
+
+      setMessages((prevMessages) => [...prevMessages, response.message]);
+    } catch (
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      error: any
+    ) {
+      console.log(error, 'type of error', typeof error);
+      console.error('Failed to send message:', error);
+
+      if (!error.message.includes('timeout') && sessionType === 'person') {
+        toast.error(t('pipelines.debugDialog.sendFailed'));
+      }
+    } finally {
+      inputRef.current?.focus();
+    }
+  };
+
+  // const resetSession = async () => {
+  //   try {
+  //     await httpClient.resetWebChatSession(selectedPipelineId, sessionType);
+  //     setMessages([]);
+  //   } catch (error) {
+  //     console.error('Failed to reset session:', error);
+  //   }
+  // };
+
+  const renderMessageContent = (message: Message) => {
+    return (
+      <span className="text-base leading-relaxed align-middle">
+        {(message.message_chain as MessageComponent[]).map(
+          (component, index) => {
+            if (component.type === 'At') {
+              return (
+                <AtBadge
+                  key={index}
+                  targetName={component.target || ''}
+                  readonly={true}
+                />
+              );
+            } else if (component.type === 'Plain') {
+              return <span key={index}>{component.text}</span>;
+            }
+            return null;
+          },
+        )}
+      </span>
+    );
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="!max-w-[70vw] max-w-6xl h-[70vh] p-6 flex flex-col rounded-2xl shadow-2xl bg-white">
+        <DialogHeader className="pl-2">
+          <div className="flex items-center justify-between">
+            <DialogTitle className="flex items-center gap-4 font-bold">
+              {t('pipelines.debugDialog.title')}
+              <Select
+                value={selectedPipelineId}
+                onValueChange={(value) => {
+                  setSelectedPipelineId(value);
+                  loadMessages(value);
+                }}
+              >
+                <SelectTrigger className="bg-white">
+                  <SelectValue />
+                </SelectTrigger>
+                <SelectContent className="rounded-xl shadow-lg">
+                  {pipelines.map((pipeline) => (
+                    <SelectItem
+                      key={pipeline.uuid}
+                      value={pipeline.uuid || ''}
+                      className="rounded-lg"
+                    >
+                      {pipeline.name}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+            </DialogTitle>
+          </div>
+        </DialogHeader>
+        <div className="flex flex-1 h-full min-h-0 border-t">
+          <div className="w-50 bg-white border-r p-6 pl-0 rounded-l-2xl flex-shrink-0 flex flex-col justify-start gap-4">
+            <div className="flex flex-col gap-2">
+              <Button
+                variant="ghost"
+                className={`w-full justify-center rounded-md px-4 py-6 text-base font-medium transition-none ${
+                  sessionType === 'person'
+                    ? 'bg-[#2288ee] text-white hover:bg-[#2288ee] hover:text-white'
+                    : 'bg-white text-gray-800 hover:bg-gray-100'
+                } border-0 shadow-none`}
+                onClick={() => setSessionType('person')}
+              >
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  viewBox="0 0 24 24"
+                  fill="currentColor"
+                >
+                  <path d="M4 22C4 17.5817 7.58172 14 12 14C16.4183 14 20 17.5817 20 22H18C18 18.6863 15.3137 16 12 16C8.68629 16 6 18.6863 6 22H4ZM12 13C8.685 13 6 10.315 6 7C6 3.685 8.685 1 12 1C15.315 1 18 3.685 18 7C18 10.315 15.315 13 12 13ZM12 11C14.21 11 16 9.21 16 7C16 4.79 14.21 3 12 3C9.79 3 8 4.79 8 7C8 9.21 9.79 11 12 11Z"></path>
+                </svg>
+                {t('pipelines.debugDialog.privateChat')}
+              </Button>
+              <Button
+                variant="ghost"
+                className={`w-full justify-center rounded-md px-4 py-6 text-base font-medium transition-none ${
+                  sessionType === 'group'
+                    ? 'bg-[#2288ee] text-white hover:bg-[#2288ee] hover:text-white'
+                    : 'bg-white text-gray-800 hover:bg-gray-100'
+                } border-0 shadow-none`}
+                onClick={() => setSessionType('group')}
+              >
+                <svg
+                  xmlns="http://www.w3.org/2000/svg"
+                  viewBox="0 0 24 24"
+                  fill="currentColor"
+                >
+                  <path d="M2 22C2 17.5817 5.58172 14 10 14C14.4183 14 18 17.5817 18 22H16C16 18.6863 13.3137 16 10 16C6.68629 16 4 18.6863 4 22H2ZM10 13C6.685 13 4 10.315 4 7C4 3.685 6.685 1 10 1C13.315 1 16 3.685 16 7C16 10.315 13.315 13 10 13ZM10 11C12.21 11 14 9.21 14 7C14 4.79 12.21 3 10 3C7.79 3 6 4.79 6 7C6 9.21 7.79 11 10 11ZM18.2837 14.7028C21.0644 15.9561 23 18.752 23 22H21C21 19.564 19.5483 17.4671 17.4628 16.5271L18.2837 14.7028ZM17.5962 3.41321C19.5944 4.23703 21 6.20361 21 8.5C21 11.3702 18.8042 13.7252 16 13.9776V11.9646C17.6967 11.7222 19 10.264 19 8.5C19 7.11935 18.2016 5.92603 17.041 5.35635L17.5962 3.41321Z"></path>
+                </svg>
+                {t('pipelines.debugDialog.groupChat')}
+              </Button>
+            </div>
+            <div className="flex-1" />
+          </div>
+
+          <div className="flex-1 flex flex-col w-[10rem] h-full min-h-0">
+            <ScrollArea className="flex-1 p-6 overflow-y-auto min-h-0 bg-white">
+              <div className="space-y-6">
+                {messages.length === 0 ? (
+                  <div className="text-center text-muted-foreground py-12 text-lg">
+                    {t('pipelines.debugDialog.noMessages')}
+                  </div>
+                ) : (
+                  messages.map((message) => (
+                    <div
+                      key={message.id + message.timestamp}
+                      className={cn(
+                        'flex',
+                        message.role === 'user'
+                          ? 'justify-end'
+                          : 'justify-start',
+                      )}
+                    >
+                      <div
+                        className={cn(
+                          'max-w-md px-5 py-3 rounded-2xl',
+                          message.role === 'user'
+                            ? 'bg-[#2288ee] text-white rounded-br-none'
+                            : 'bg-gray-100 text-gray-900 rounded-bl-none',
+                        )}
+                      >
+                        {renderMessageContent(message)}
+                        <div
+                          className={cn(
+                            'text-xs mt-2',
+                            message.role === 'user'
+                              ? 'text-white/70'
+                              : 'text-gray-500',
+                          )}
+                        >
+                          {message.role === 'user'
+                            ? t('pipelines.debugDialog.userMessage')
+                            : t('pipelines.debugDialog.botMessage')}
+                        </div>
+                      </div>
+                    </div>
+                  ))
+                )}
+                <div ref={messagesEndRef} />
+              </div>
+            </ScrollArea>
+
+            <div className="border-t p-4 pb-0 bg-white flex gap-2">
+              <div className="flex-1 flex items-center gap-2">
+                {hasAt && (
+                  <AtBadge targetName="webchatbot" onRemove={handleAtRemove} />
+                )}
+                <div className="relative flex-1">
+                  <Input
+                    ref={inputRef}
+                    value={inputValue}
+                    onChange={handleInputChange}
+                    onKeyPress={handleKeyPress}
+                    placeholder={t('pipelines.debugDialog.inputPlaceholder')}
+                    className="flex-1 rounded-md px-3 py-2 border border-gray-300 focus:border-[#2288ee] transition-none text-base"
+                  />
+                  {showAtPopover && (
+                    <div
+                      ref={popoverRef}
+                      className="absolute bottom-full left-0 mb-2 w-auto rounded-md border bg-white shadow-lg"
+                    >
+                      <div
+                        className={cn(
+                          'flex items-center gap-2 px-4 py-1.5 rounded cursor-pointer',
+                          isHovering ? 'bg-gray-100' : 'bg-white',
+                        )}
+                        onClick={handleAtSelect}
+                        onMouseEnter={() => setIsHovering(true)}
+                        onMouseLeave={() => setIsHovering(false)}
+                      >
+                        <span>
+                          @webchatbot - {t('pipelines.debugDialog.atTips')}
+                        </span>
+                      </div>
+                    </div>
+                  )}
+                </div>
+              </div>
+              <Button
+                onClick={sendMessage}
+                disabled={!inputValue.trim() && !hasAt}
+                className="rounded-md bg-[#2288ee] hover:bg-[#2288ee] w-20 text-white px-6 py-2 text-base font-medium transition-none flex items-center gap-2 shadow-none"
+              >
+                <>{t('pipelines.debugDialog.send')}</>
+              </Button>
+            </div>
+          </div>
+        </div>
+      </DialogContent>
+    </Dialog>
+  );
+}
--- a/web/src/app/home/pipelines/page.tsx
+++ b/web/src/app/home/pipelines/page.tsx
@@ -15,6 +15,8 @@ import {
 } from '@/components/ui/dialog';
 import { toast } from 'sonner';
 import { useTranslation } from 'react-i18next';
+import DebugDialog from './debug-dialog/DebugDialog';
+
 export default function PluginConfigPage() {
  const { t } = useTranslation();
  const [modalOpen, setModalOpen] = useState<boolean>(false);
@@ -32,6 +34,8 @@ export default function PluginConfigPage() {
  const [disableForm, setDisableForm] = useState(false);
  const [selectedPipelineIsDefault, setSelectedPipelineIsDefault] =
    useState(false);
+  const [debugDialogOpen, setDebugDialogOpen] = useState(false);
+  const [debugPipelineId, setDebugPipelineId] = useState('');

  useEffect(() => {
    getPipelines();
@@ -92,6 +96,11 @@ export default function PluginConfigPage() {
    });
  }

+  const handleDebug = (pipelineId: string) => {
+    setDebugPipelineId(pipelineId);
+    setDebugDialogOpen(true);
+  };
+
  return (
    <div className={styles.configPageContainer}>
      <Dialog open={modalOpen} onOpenChange={setModalOpen}>
@@ -149,11 +158,17 @@ export default function PluginConfigPage() {
                getSelectedPipelineForm(pipeline.id);
              }}
            >
-              <PipelineCard cardVO={pipeline} />
+              <PipelineCard cardVO={pipeline} onDebug={handleDebug} />
            </div>
          );
        })}
      </div>
+
+      <DebugDialog
+        open={debugDialogOpen}
+        onOpenChange={setDebugDialogOpen}
+        pipelineId={debugPipelineId}
+      />
    </div>
  );
 }
--- a/web/src/app/infra/entities/api/index.ts
+++ b/web/src/app/infra/entities/api/index.ts
@@ -1,6 +1,7 @@
 import { IDynamicFormItemSchema } from '@/app/infra/entities/form/dynamic';
 import { PipelineConfigTab } from '@/app/infra/entities/pipeline';
 import { I18nLabel } from '@/app/infra/entities/common';
+import { Message } from '@/app/infra/entities/message';

 export interface ApiResponse<T> {
  code: number;
@@ -228,3 +229,11 @@ export interface GetPipelineResponseData {
 export interface GetPipelineMetadataResponseData {
  configs: PipelineConfigTab[];
 }
+
+export interface ApiRespWebChatMessage {
+  message: Message;
+}
+
+export interface ApiRespWebChatMessages {
+  messages: Message[];
+}
--- a/web/src/app/infra/entities/message/index.ts
+++ b/web/src/app/infra/entities/message/index.ts
@@ -0,0 +1,7 @@
+export interface Message {
+  id: number;
+  role: 'user' | 'assistant';
+  content: string;
+  message_chain: object[];
+  timestamp: string;
+}
--- a/web/src/app/infra/http/HttpClient.ts
+++ b/web/src/app/infra/http/HttpClient.ts
@@ -29,6 +29,8 @@ import {
  GetPipelineResponseData,
  GetPipelineMetadataResponseData,
  AsyncTask,
+  ApiRespWebChatMessage,
+  ApiRespWebChatMessages,
 } from '@/app/infra/entities/api';
 import { GetBotLogsRequest } from '@/app/infra/http/requestParam/bots/GetBotLogsRequest';
 import { GetBotLogsResponse } from '@/app/infra/http/requestParam/bots/GetBotLogsResponse';
@@ -301,6 +303,43 @@ class HttpClient {
    return this.delete(`/api/v1/pipelines/${uuid}`);
  }

+  // ============ Debug WebChat API ============
+  public sendWebChatMessage(
+    sessionType: string,
+    messageChain: object[],
+    pipelineId: string,
+    timeout: number = 15000,
+  ): Promise<ApiRespWebChatMessage> {
+    return this.post(
+      `/api/v1/pipelines/${pipelineId}/chat/send`,
+      {
+        session_type: sessionType,
+        message: messageChain,
+      },
+      {
+        timeout,
+      },
+    );
+  }
+
+  public getWebChatHistoryMessages(
+    pipelineId: string,
+    sessionType: string,
+  ): Promise<ApiRespWebChatMessages> {
+    return this.get(
+      `/api/v1/pipelines/${pipelineId}/chat/messages/${sessionType}`,
+    );
+  }
+
+  public resetWebChatSession(
+    pipelineId: string,
+    sessionType: string,
+  ): Promise<{ message: string }> {
+    return this.post(
+      `/api/v1/pipelines/${pipelineId}/chat/reset/${sessionType}`,
+    );
+  }
+
  // ============ Platform API ============
  public getAdapters(): Promise<ApiRespPlatformAdapters> {
    return this.get('/api/v1/platform/adapters');
@@ -456,8 +495,8 @@ class HttpClient {
 }

 // export const httpClient = new HttpClient('https://event-log.langbot.dev');
-// export const httpClient = new HttpClient('http://localhost:5300');
-export const httpClient = new HttpClient('/');
+export const httpClient = new HttpClient('http://localhost:5300');
+// export const httpClient = new HttpClient('/');

 // 临时写法，未来两种Client都继承自HttpClient父类，不允许共享方法
 export const spaceClient = new HttpClient('https://space.langbot.app');
--- a/web/src/components/ui/popover.tsx
+++ b/web/src/components/ui/popover.tsx
@@ -0,0 +1,48 @@
+'use client';
+
+import * as React from 'react';
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+
+import { cn } from '@/lib/utils';
+
+function Popover({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Root>) {
+  return <PopoverPrimitive.Root data-slot="popover" {...props} />;
+}
+
+function PopoverTrigger({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Trigger>) {
+  return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />;
+}
+
+function PopoverContent({
+  className,
+  align = 'center',
+  sideOffset = 4,
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Content>) {
+  return (
+    <PopoverPrimitive.Portal>
+      <PopoverPrimitive.Content
+        data-slot="popover-content"
+        align={align}
+        sideOffset={sideOffset}
+        className={cn(
+          'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-72 origin-(--radix-popover-content-transform-origin) rounded-md border p-4 shadow-md outline-hidden',
+          className,
+        )}
+        {...props}
+      />
+    </PopoverPrimitive.Portal>
+  );
+}
+
+function PopoverAnchor({
+  ...props
+}: React.ComponentProps<typeof PopoverPrimitive.Anchor>) {
+  return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />;
+}
+
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };
--- a/web/src/components/ui/scroll-area.tsx
+++ b/web/src/components/ui/scroll-area.tsx
@@ -0,0 +1,58 @@
+'use client';
+
+import * as React from 'react';
+import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
+
+import { cn } from '@/lib/utils';
+
+function ScrollArea({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof ScrollAreaPrimitive.Root>) {
+  return (
+    <ScrollAreaPrimitive.Root
+      data-slot="scroll-area"
+      className={cn('relative', className)}
+      {...props}
+    >
+      <ScrollAreaPrimitive.Viewport
+        data-slot="scroll-area-viewport"
+        className="focus-visible:ring-ring/50 size-full rounded-[inherit] transition-[color,box-shadow] outline-none focus-visible:ring-[3px] focus-visible:outline-1"
+      >
+        {children}
+      </ScrollAreaPrimitive.Viewport>
+      <ScrollBar />
+      <ScrollAreaPrimitive.Corner />
+    </ScrollAreaPrimitive.Root>
+  );
+}
+
+function ScrollBar({
+  className,
+  orientation = 'vertical',
+  ...props
+}: React.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>) {
+  return (
+    <ScrollAreaPrimitive.ScrollAreaScrollbar
+      data-slot="scroll-area-scrollbar"
+      orientation={orientation}
+      className={cn(
+        'flex touch-none p-px transition-colors select-none',
+        orientation === 'vertical' &&
+          'h-full w-2.5 border-l border-l-transparent',
+        orientation === 'horizontal' &&
+          'h-2.5 flex-col border-t border-t-transparent',
+        className,
+      )}
+      {...props}
+    >
+      <ScrollAreaPrimitive.ScrollAreaThumb
+        data-slot="scroll-area-thumb"
+        className="bg-border relative flex-1 rounded-full"
+      />
+    </ScrollAreaPrimitive.ScrollAreaScrollbar>
+  );
+}
+
+export { ScrollArea, ScrollBar };
--- a/web/src/i18n/locales/en-US.ts
+++ b/web/src/i18n/locales/en-US.ts
@@ -183,6 +183,7 @@ const enUS = {
      'Pipelines define the processing flow for message events, used to bind to bots',
    createPipeline: 'Create Pipeline',
    editPipeline: 'Edit Pipeline',
+    chat: 'Chat',
    getPipelineListError: 'Failed to get pipeline list: ',
    daysAgo: 'days ago',
    today: 'Today',
@@ -202,6 +203,25 @@ const enUS = {
    deleteConfirmation:
      'Are you sure you want to delete this pipeline? Bots bound to this pipeline will not work.',
    defaultPipelineCannotDelete: 'Default pipeline cannot be deleted',
+    debugDialog: {
+      title: 'Pipeline Chat',
+      selectPipeline: 'Select Pipeline',
+      sessionType: 'Session Type',
+      privateChat: 'Private Chat',
+      groupChat: 'Group Chat',
+      send: 'Send',
+      reset: 'Reset Conversation',
+      inputPlaceholder: 'Enter message...',
+      noMessages: 'No messages',
+      userMessage: 'User',
+      botMessage: 'Bot',
+      sendFailed: 'Send failed',
+      resetSuccess: 'Conversation reset successfully',
+      resetFailed: 'Reset failed',
+      loadMessagesFailed: 'Failed to load messages',
+      loadPipelinesFailed: 'Failed to load pipelines',
+      atTips: 'Mention the bot',
+    },
  },
  register: {
    title: 'Initialize LangBot 👋',
--- a/web/src/i18n/locales/zh-Hans.ts
+++ b/web/src/i18n/locales/zh-Hans.ts
@@ -178,6 +178,7 @@ const zhHans = {
    description: '流水线定义了对消息事件的处理流程，用于绑定到机器人',
    createPipeline: '创建流水线',
    editPipeline: '编辑流水线',
+    chat: '对话',
    getPipelineListError: '获取流水线列表失败：',
    daysAgo: '天前',
    today: '今天',
@@ -197,6 +198,25 @@ const zhHans = {
    deleteConfirmation:
      '你确定要删除这个流水线吗？已绑定此流水线的机器人将无法使用。',
    defaultPipelineCannotDelete: '默认流水线不可删除',
+    debugDialog: {
+      title: '流水线对话',
+      selectPipeline: '选择流水线',
+      sessionType: '会话类型',
+      privateChat: '私聊',
+      groupChat: '群聊',
+      send: '发送',
+      reset: '重置对话',
+      inputPlaceholder: '输入消息...',
+      noMessages: '暂无消息',
+      userMessage: '用户',
+      botMessage: '机器人',
+      sendFailed: '发送失败',
+      resetSuccess: '对话已重置',
+      resetFailed: '重置失败',
+      loadMessagesFailed: '加载消息失败',
+      loadPipelinesFailed: '加载流水线失败',
+      atTips: '提及机器人',
+    },
  },
  register: {
    title: '初始化 LangBot 👋',