LibreChatCông cụ
Cấu hình các công cụ tác nhân tích hợp trong LibreChat
Các công cụ của LibreChat được chọn từ Agent Builder và chạy khi một agent quyết định rằng chúng hữu ích. Phần này bao gồm các công cụ agent tích hợp sẵn như tạo hình ảnh, tìm kiếm, thời tiết, tính toán và tra cứu chỉ mục riêng tư.
Không giống với Web Search hoặc MCP
Các công cụ tìm kiếm trên trang này là các công cụ bạn thêm vào một agent cụ thể. Tính năng Web Search tích hợp sẵn của LibreChat được cấu hình riêng biệt, và các công cụ tùy chỉnh của bên thứ ba thường được thêm thông qua MCP hoặc Actions.
Thiết lập nhanh
Chọn Công cụ
Chọn một công cụ từ bảng dưới đây và thu thập mọi API key, service URL hoặc tên chỉ mục cần thiết.
Thêm thông tin xác thực
Thêm các giá trị bắt buộc vào tệp .env của bạn, hoặc để người dùng tự cung cấp thông tin xác thực của riêng họ từ giao diện người dùng LibreChat khi công cụ yêu cầu.
Khởi động lại LibreChat
Các thay đổi về biến môi trường sẽ được tải khi khởi động lại.
| Triển khai | Lệnh |
|---|---|
| Docker | docker compose down && docker compose up -d |
| Local | Dừng máy chủ, sau đó chạy lại npm run backend |
Thêm Công cụ vào một Agent
Trong LibreChat, hãy chọn Agents, tạo hoặc chỉnh sửa một agent, mở danh sách Tools của agent đó, chọn công cụ, và lưu agent lại.
Kiểm tra trong Chat
Bắt đầu một cuộc trò chuyện với agent đó và yêu cầu một việc gì đó cần sử dụng công cụ, chẳng hạn như tìm kiếm, tính toán, báo cáo thời tiết hoặc hình ảnh.
Các công cụ tích hợp sẵn hiện tại
| Công cụ | Sử dụng cho | Cấu hình bắt buộc | Chi tiết |
|---|---|---|---|
| OpenAI Image Tools | Tạo và chỉnh sửa hình ảnh với các mô hình hình ảnh của OpenAI | IMAGE_GEN_OAI_API_KEY; tùy chọn IMAGE_GEN_OAI_MODEL | Tạo hình ảnh |
| Gemini Image Tools | Tạo hình ảnh và chỉnh sửa với ngữ cảnh hình ảnh sử dụng Gemini | GEMINI_API_KEY, GOOGLE_KEY, hoặc GOOGLE_SERVICE_KEY_FILE; tùy chọn GEMINI_IMAGE_MODEL | Tạo hình ảnh Gemini |
| DALL-E-3 | Tạo hình ảnh OpenAI phiên bản cũ | DALLE3_API_KEY hoặc DALLE_API_KEY | DALL-E |
| Flux | Tạo hình ảnh trên đám mây và các mô hình hình ảnh được tinh chỉnh | FLUX_API_KEY; tùy chọn FLUX_API_BASE_URL | Flux |
| Stable Diffusion | Tạo hình ảnh cục bộ hoặc tự lưu trữ thông qua Automatic1111 | SD_WEBUI_URL | Stable Diffusion |
| Google Search | Kết quả Google Custom Search cho một tác nhân (agent) | GOOGLE_SEARCH_API_KEY và GOOGLE_CSE_ID | Google Search |
| Tavily Search | Kết quả web hiện tại được tối ưu hóa cho các tác nhân | TAVILY_API_KEY | Tavily Search |
| Traversaal | Kết quả tìm kiếm AI kèm nguồn trích dẫn | TRAVERSAAL_API_KEY | Traversaal |
| Azure AI Search | Tìm kiếm chỉ mục Azure AI Search riêng tư | AZURE_AI_SEARCH_SERVICE_ENDPOINT, AZURE_AI_SEARCH_INDEX_NAME, AZURE_AI_SEARCH_API_KEY | Azure AI Search |
| OpenWeather | Dữ liệu thời tiết hiện tại, dự báo, lịch sử và hàng ngày | OPENWEATHER_API_KEY | OpenWeather |
| Wolfram|Alpha | Toán học, tính toán, đơn vị, kiến thức được chọn lọc và dữ liệu thời gian thực | WOLFRAM_APP_ID | Wolfram|Alpha |
| Calculator | Các phép tính cơ bản và phức tạp | Không có | Calculator |
Tạo Custom Tools
Hầu hết các công cụ tùy chỉnh nên được thêm vào mà không cần chỉnh sửa mã nguồn LibreChat.
- Sử dụng MCP khi bạn muốn kết nối một agent với một tập lệnh cục bộ, dịch vụ nội bộ, cơ sở dữ liệu, máy chủ tự động hóa trình duyệt hoặc một trình bao bọc API tùy chỉnh. Ví dụ, một công cụ tìm kiếm DuckDuckGo có thể được hiển thị thông qua một máy chủ MCP và sau đó được chọn từ Agent Builder.
- Sử dụng Actions khi công cụ là một HTTP API có thể được mô tả bằng lược đồ OpenAPI.
- Chỉ chỉnh sửa các công cụ có cấu trúc ở cấp độ nguồn của LibreChat khi bạn đang tự phát triển LibreChat. Hướng dẫn phát triển Tools and Plugins cũ vẫn khả dụng cho các cộng tác viên, nhưng MCP và Actions là các hướng mở rộng được khuyến nghị cho các bản triển khai.
Tính khả dụng của công cụ
Các công cụ được xác định nội bộ bằng pluginKey của chúng từ api/app/clients/tools/manifest.json của LibreChat.
Sử dụng filteredTools để ẩn các công cụ, hoặc includedTools để chỉ cho phép các công cụ cụ thể:
includedTools:
- calculator
- image_gen_oai
- googleNếu một tool không hiển thị trong Agent Builder sau khi khởi động lại, hãy kiểm tra các biến môi trường của tool đó, includedTools, filteredTools, và xem liệu khả năng tools của agent đã được bật hay chưa.
Hướng dẫn này thế nào?