Agent Chat UI 使用教程
1. 项目介绍
Agent Chat UI 是一个基于 Vite 和 React 的应用程序,它允许用户通过聊天界面与任何具有 messages
键的 LangGraph 服务器进行交流。这个项目旨在提供一个简单的界面,让用户可以轻松地与 LangGraph 服务器进行交互。
2. 项目快速启动
环境准备
在开始之前,请确保您的系统中已安装以下依赖:
- Node.js
- npm 或 yarn
克隆项目
您可以选择以下任一方式克隆项目:
npx create-agent-chat-app
或者使用 Git 命令克隆:
git clone https://github.com/langchain-ai/agent-chat-ui.git
cd agent-chat-ui
安装依赖
在项目根目录下执行以下命令安装依赖:
pnpm install
运行项目
安装完依赖后,执行以下命令启动开发服务器:
pnpm dev
项目启动后,您可以通过浏览器访问 http://localhost:5173
查看应用。
3. 应用案例和最佳实践
部署 URL 和 Assistant/Graph ID
当应用运行后,您需要输入以下信息:
- 部署 URL:LangGraph 服务器的 URL,可以是生产环境或开发环境的 URL。
- Assistant/Graph ID:在与聊天界面交互时使用的图的名字或助手的 ID。
LangSmith API Key
如果您连接到的是部署的 LangGraph 服务器,则需要提供 LangSmith API Key 进行身份验证。
环境变量
您可以通过设置环境变量来跳过初始设置表单:
VITE_API_URL=http://localhost:2024
VITE_ASSISTANT_ID=agent
VITE_LANGSMITH_API_KEY=your_api_key_if_needed
将 .env.example
文件复制为 .env
文件,并填入相应的值。重启应用后,应用将使用这些变量而不是显示设置表单。
隐藏聊天信息
您可以通过以下两种方式控制聊天信息在 Agent Chat UI 中的可见性:
- 阻止实时流:在聊天模型的配置中添加
langsmith:nostream
标签,以阻止消息在 LLM 调用期间显示。 - 永久隐藏消息:在将消息添加到图的状态之前,将
id
字段前缀为do-not-render-
,并在聊天模型的配置中添加langsmith:do-not-render
标签。
4. 典型生态项目
目前,Agent Chat UI 主要是作为 LangGraph 服务器的一个前端界面存在。在开源生态中,您可以寻找类似的项目,比如其他类型的人工智能聊天界面或者与不同后端服务集成的前端项目。这些项目可以帮助您更好地理解如何构建与 AI 交互的应用程序。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考