612b3f2c90
- Updated `config.yaml` to adjust conversation parameters for improved search performance. - Added a new `knowledgeSemanticSearch` API function for semantic search capabilities. - Introduced new SVG icons for search functionality. - Created `KnowledgeSearch.vue` component for the search interface, including query input and result display. - Enhanced menu and routing to support navigation to the new knowledge search page. - Updated internationalization files to include translations for the knowledge search feature. This update provides users with a powerful tool to perform semantic searches across knowledge bases, improving content discoverability.
310 lines
10 KiB
TypeScript
310 lines
10 KiB
TypeScript
import { get, post, put, del, postUpload, getDown } from "../../utils/request";
|
|
|
|
// 知识库管理 API(列表、创建、获取、更新、删除、复制)
|
|
export function listKnowledgeBases(params?: { agent_id?: string }) {
|
|
const query = new URLSearchParams();
|
|
if (params?.agent_id) query.set('agent_id', params.agent_id);
|
|
const qs = query.toString();
|
|
return get(qs ? `/api/v1/knowledge-bases?${qs}` : '/api/v1/knowledge-bases');
|
|
}
|
|
|
|
export function createKnowledgeBase(data: {
|
|
name: string;
|
|
description?: string;
|
|
type?: 'document' | 'faq';
|
|
chunking_config?: any;
|
|
embedding_model_id?: string;
|
|
summary_model_id?: string;
|
|
vlm_config?: {
|
|
enabled: boolean;
|
|
model_id?: string;
|
|
};
|
|
storage_config?: any;
|
|
extract_config?: any;
|
|
faq_config?: { index_mode: string; question_index_mode?: string };
|
|
}) {
|
|
return post(`/api/v1/knowledge-bases`, data);
|
|
}
|
|
|
|
export function getKnowledgeBaseById(id: string, options?: { agent_id?: string }) {
|
|
const query = new URLSearchParams();
|
|
if (options?.agent_id) query.set('agent_id', options.agent_id);
|
|
const qs = query.toString();
|
|
return get(qs ? `/api/v1/knowledge-bases/${id}?${qs}` : `/api/v1/knowledge-bases/${id}`);
|
|
}
|
|
|
|
export function updateKnowledgeBase(id: string, data: { name: string; description?: string; config: any }) {
|
|
return put(`/api/v1/knowledge-bases/${id}` , data);
|
|
}
|
|
|
|
export function deleteKnowledgeBase(id: string) {
|
|
return del(`/api/v1/knowledge-bases/${id}`);
|
|
}
|
|
|
|
export function copyKnowledgeBase(data: { source_id: string; target_id?: string }) {
|
|
return post(`/api/v1/knowledge-bases/copy`, data);
|
|
}
|
|
|
|
// 知识文件 API(基于具体知识库)
|
|
// data.tag_id: 可选,指定知识所属的分类ID
|
|
export function uploadKnowledgeFile(kbId: string, data: { file: File; tag_id?: string; [key: string]: any } = { file: new File([], '') }, onProgress?: (progressEvent: any) => void) {
|
|
const formData = new FormData();
|
|
Object.keys(data).forEach(key => {
|
|
if (data[key] !== undefined) formData.append(key, data[key]);
|
|
});
|
|
return postUpload(`/api/v1/knowledge-bases/${kbId}/knowledge/file`, formData, onProgress);
|
|
}
|
|
|
|
// 从URL创建知识
|
|
// data.tag_id: 可选,指定知识所属的分类ID
|
|
export function createKnowledgeFromURL(kbId: string, data: { url: string; enable_multimodel?: boolean; tag_id?: string }) {
|
|
return post(`/api/v1/knowledge-bases/${kbId}/knowledge/url`, data);
|
|
}
|
|
|
|
// 手工创建知识
|
|
// data.tag_id: 可选,指定知识所属的分类ID
|
|
export function createManualKnowledge(kbId: string, data: { title: string; content: string; status: string; tag_id?: string }) {
|
|
return post(`/api/v1/knowledge-bases/${kbId}/knowledge/manual`, data);
|
|
}
|
|
|
|
export function listKnowledgeFiles(
|
|
kbId: string,
|
|
params: { page: number; page_size: number; tag_id?: string; keyword?: string; file_type?: string },
|
|
) {
|
|
const query = new URLSearchParams();
|
|
query.append('page', String(params.page));
|
|
query.append('page_size', String(params.page_size));
|
|
if (params.tag_id) {
|
|
query.append('tag_id', params.tag_id);
|
|
}
|
|
if (params.keyword) {
|
|
query.append('keyword', params.keyword);
|
|
}
|
|
if (params.file_type) {
|
|
query.append('file_type', params.file_type);
|
|
}
|
|
const qs = query.toString();
|
|
return get(`/api/v1/knowledge-bases/${kbId}/knowledge?${qs}`);
|
|
}
|
|
|
|
export function getKnowledgeDetails(id: string, options?: { agent_id?: string }) {
|
|
const query = new URLSearchParams();
|
|
if (options?.agent_id) query.set('agent_id', options.agent_id);
|
|
const qs = query.toString();
|
|
return get(qs ? `/api/v1/knowledge/${id}?${qs}` : `/api/v1/knowledge/${id}`);
|
|
}
|
|
|
|
export function updateManualKnowledge(id: string, data: { title: string; content: string; status: string }) {
|
|
return put(`/api/v1/knowledge/manual/${id}`, data);
|
|
}
|
|
|
|
export function delKnowledgeDetails(id: string) {
|
|
return del(`/api/v1/knowledge/${id}`);
|
|
}
|
|
|
|
export function downKnowledgeDetails(id: string) {
|
|
return getDown(`/api/v1/knowledge/${id}/download`);
|
|
}
|
|
|
|
export function previewKnowledgeFile(id: string) {
|
|
return getDown(`/api/v1/knowledge/${id}/preview`);
|
|
}
|
|
|
|
/** @param idsQueryString - query string with ids (e.g. ids=xxx&ids=yyy) */
|
|
export function batchQueryKnowledge(idsQueryString: string, kbId?: string, agentId?: string) {
|
|
let qs = idsQueryString;
|
|
if (kbId) qs += `&kb_id=${encodeURIComponent(kbId)}`;
|
|
if (agentId) qs += `&agent_id=${encodeURIComponent(agentId)}`;
|
|
return get(`/api/v1/knowledge/batch?${qs}`);
|
|
}
|
|
|
|
export function getKnowledgeDetailsCon(id: string, page: number) {
|
|
return get(`/api/v1/chunks/${id}?page=${page}&page_size=25`);
|
|
}
|
|
|
|
// Get chunk by chunk_id only (new endpoint - to be added to backend)
|
|
export function getChunkByIdOnly(chunkId: string) {
|
|
return get(`/api/v1/chunks/by-id/${chunkId}`);
|
|
}
|
|
|
|
// Delete a single generated question from a chunk by question ID
|
|
export function deleteGeneratedQuestion(chunkId: string, questionId: string) {
|
|
return del(`/api/v1/chunks/by-id/${chunkId}/questions`, { question_id: questionId });
|
|
}
|
|
|
|
export function listKnowledgeTags(
|
|
kbId: string,
|
|
params?: { page?: number; page_size?: number; keyword?: string },
|
|
) {
|
|
const query = buildQuery(params);
|
|
return get(`/api/v1/knowledge-bases/${kbId}/tags${query}`);
|
|
}
|
|
|
|
export function createKnowledgeBaseTag(
|
|
kbId: string,
|
|
data: { name: string; color?: string; sort_order?: number },
|
|
) {
|
|
return post(`/api/v1/knowledge-bases/${kbId}/tags`, data);
|
|
}
|
|
|
|
export function updateKnowledgeBaseTag(
|
|
kbId: string,
|
|
tagId: string,
|
|
data: { name?: string; color?: string; sort_order?: number },
|
|
) {
|
|
return put(`/api/v1/knowledge-bases/${kbId}/tags/${tagId}`, data);
|
|
}
|
|
|
|
export function deleteKnowledgeBaseTag(kbId: string, tagSeqId: number, params?: { force?: boolean }) {
|
|
const forceQuery = params?.force ? '?force=true' : '';
|
|
return del(`/api/v1/knowledge-bases/${kbId}/tags/${tagSeqId}${forceQuery}`);
|
|
}
|
|
|
|
export function updateKnowledgeTagBatch(data: { updates: Record<string, string | null> }) {
|
|
return put(`/api/v1/knowledge/tags`, data);
|
|
}
|
|
|
|
export function updateFAQEntryTagBatch(kbId: string, data: { updates: Record<number, number | null> }) {
|
|
return put(`/api/v1/knowledge-bases/${kbId}/faq/entries/tags`, data);
|
|
}
|
|
|
|
const buildQuery = (params?: Record<string, any>) => {
|
|
if (!params) return '';
|
|
const query = new URLSearchParams();
|
|
Object.entries(params).forEach(([key, value]) => {
|
|
if (value === undefined || value === null || value === '') return;
|
|
query.append(key, String(value));
|
|
});
|
|
const queryString = query.toString();
|
|
return queryString ? `?${queryString}` : '';
|
|
};
|
|
|
|
export function listFAQEntries(
|
|
kbId: string,
|
|
params?: { page?: number; page_size?: number; tag_id?: number; keyword?: string },
|
|
) {
|
|
const query = buildQuery(params);
|
|
return get(`/api/v1/knowledge-bases/${kbId}/faq/entries${query}`);
|
|
}
|
|
|
|
export function upsertFAQEntries(kbId: string, data: { entries: any[]; mode: 'append' | 'replace' }) {
|
|
return post(`/api/v1/knowledge-bases/${kbId}/faq/entries`, data);
|
|
}
|
|
|
|
export function createFAQEntry(kbId: string, data: any) {
|
|
return post(`/api/v1/knowledge-bases/${kbId}/faq/entry`, data);
|
|
}
|
|
|
|
export function updateFAQEntry(kbId: string, entryId: number, data: any) {
|
|
return put(`/api/v1/knowledge-bases/${kbId}/faq/entries/${entryId}`, data);
|
|
}
|
|
|
|
// Unified batch update API - supports is_enabled, is_recommended, tag_id
|
|
// Supports two modes:
|
|
// 1. By entry ID: use by_id field
|
|
// 2. By Tag: use by_tag field to apply the same update to all entries under a tag
|
|
export interface FAQEntryFieldsUpdate {
|
|
is_enabled?: boolean
|
|
is_recommended?: boolean
|
|
tag_id?: number | null
|
|
}
|
|
|
|
export interface FAQEntryFieldsBatchRequest {
|
|
by_id?: Record<number, FAQEntryFieldsUpdate>
|
|
by_tag?: Record<number, FAQEntryFieldsUpdate>
|
|
exclude_ids?: number[]
|
|
}
|
|
|
|
export function updateFAQEntryFieldsBatch(kbId: string, data: FAQEntryFieldsBatchRequest) {
|
|
return put(`/api/v1/knowledge-bases/${kbId}/faq/entries/fields`, data);
|
|
}
|
|
|
|
export function deleteFAQEntries(kbId: string, ids: number[]) {
|
|
return del(`/api/v1/knowledge-bases/${kbId}/faq/entries`, { ids });
|
|
}
|
|
|
|
export function searchFAQEntries(
|
|
kbId: string,
|
|
data: {
|
|
query_text: string
|
|
vector_threshold?: number
|
|
match_count?: number
|
|
}
|
|
) {
|
|
return post(`/api/v1/knowledge-bases/${kbId}/faq/search`, data);
|
|
}
|
|
|
|
// Export FAQ entries as CSV file
|
|
export async function exportFAQEntries(kbId: string): Promise<Blob> {
|
|
const response = await getDown(`/api/v1/knowledge-bases/${kbId}/faq/entries/export`);
|
|
return response as unknown as Blob;
|
|
}
|
|
|
|
// FAQ Import Progress API
|
|
export interface FAQBlockedEntry {
|
|
index: number
|
|
standard_question: string
|
|
reason: string
|
|
}
|
|
|
|
export interface FAQSuccessEntry {
|
|
index: number
|
|
seq_id: number
|
|
tag_id?: number
|
|
tag_name?: string
|
|
standard_question: string
|
|
}
|
|
|
|
export interface FAQImportProgress {
|
|
task_id: string
|
|
kb_id: string
|
|
knowledge_id: string
|
|
status: 'pending' | 'processing' | 'completed' | 'failed'
|
|
progress: number
|
|
total: number
|
|
processed: number
|
|
blocked: number
|
|
blocked_entries?: FAQBlockedEntry[]
|
|
success_entries?: FAQSuccessEntry[]
|
|
message: string
|
|
error: string
|
|
created_at: number
|
|
updated_at: number
|
|
}
|
|
|
|
export function getFAQImportProgress(taskId: string) {
|
|
return get(`/api/v1/faq/import/progress/${taskId}`);
|
|
}
|
|
|
|
export function updateFAQImportResultDisplayStatus(knowledgeBaseId: string, displayStatus: 'open' | 'close') {
|
|
return put(`/api/v1/knowledge-bases/${knowledgeBaseId}/faq/import/last-result/display`, {
|
|
display_status: displayStatus
|
|
});
|
|
}
|
|
|
|
export function searchKnowledge(
|
|
keyword: string,
|
|
offset = 0,
|
|
limit = 20,
|
|
fileTypes?: string[],
|
|
options?: { agent_id?: string }
|
|
) {
|
|
const query = new URLSearchParams();
|
|
query.set('keyword', keyword);
|
|
query.set('offset', String(offset));
|
|
query.set('limit', String(limit));
|
|
if (fileTypes && fileTypes.length > 0) {
|
|
query.set('file_types', fileTypes.join(','));
|
|
}
|
|
if (options?.agent_id) query.set('agent_id', options.agent_id);
|
|
return get(`/api/v1/knowledge/search?${query.toString()}`);
|
|
}
|
|
|
|
export function knowledgeSemanticSearch(data: {
|
|
query: string;
|
|
knowledge_base_ids?: string[];
|
|
knowledge_ids?: string[];
|
|
}) {
|
|
return post('/api/v1/knowledge-search', data);
|
|
}
|