Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

17.5 KB
Raw Blame
//
//  Copyright 2026 The InfiniFlow Authors. All Rights Reserved.
//
//  Licensed under the Apache License, Version 2.0 (the "License");
//  you may not use this file except in compliance with the License.
//  You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//

package models

import (
	"bytes"
	"context"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"ragflow/internal/common"
	"strings"
)

type HuaweiCloudModel struct {
	baseModel BaseModel
}

func NewHuaweiCloudModel(baseURL map[string]string, urlSuffix URLSuffix) *HuaweiCloudModel {
	return &HuaweiCloudModel{
		baseModel: BaseModel{
			BaseURL:    baseURL,
			URLSuffix:  urlSuffix,
			httpClient: common.GetSSRFHTTPClient(),
		},
	}
}

func (h *HuaweiCloudModel) NewInstance(baseURL map[string]string) ModelDriver {
	return NewHuaweiCloudModel(baseURL, h.baseModel.URLSuffix)
}

func (h *HuaweiCloudModel) Name() string {
	return "huaweicloud"
}

func huaweiCloudRegion(api *APIConfig) string {
	region := "default"
	if api != nil && api.Region != nil && *api.Region != "" {
		region = *api.Region
	}
	return region
}

func huaweiCloudRegionForModel(api *APIConfig, modelName string) string {
	region := huaweiCloudRegion(api)
	return region
}

func huaweiCloudIsDeepSeekV4(modelName string) bool {
	model := strings.ToLower(modelName)
	return strings.Contains(model, "deepseek-v4-pro") || strings.Contains(model, "deepseek-v4-flash")
}

func huaweiCloudSupportsThinkingToggle(modelName string) bool {
	model := strings.ToLower(modelName)
	switch {
	case strings.Contains(model, "deepseek-v4-pro"),
		strings.Contains(model, "deepseek-v4-flash"),
		strings.Contains(model, "deepseek-v3.1"),
		strings.Contains(model, "deepseek-v3.2"),
		strings.Contains(model, "qwen3-235b-a22b"),
		strings.Contains(model, "qwen3-32b"),
		strings.Contains(model, "qwen3-30b-a3b"),
		strings.Contains(model, "glm-5.1"),
		strings.Contains(model, "glm-5"),
		strings.Contains(model, "kimi-k2.6"):
		return true
	default:
		return false
	}
}

func huaweiCloudUsesV1Chat(modelName string) bool {
	model := strings.ToLower(modelName)
	return model == "deepseek-v3"
}

func huaweiCloudChatModelName(modelName string) string {
	if huaweiCloudUsesV1Chat(modelName) {
		return strings.ToLower(modelName)
	}
	return modelName
}

func huaweiCloudAuthorization(apiKey string) string {
	key := strings.TrimSpace(apiKey)
	if strings.HasPrefix(strings.ToLower(key), "bearer ") {
		key = strings.TrimSpace(key[len("bearer "):])
	}
	return fmt.Sprintf("Bearer %s", key)
}

func (h *HuaweiCloudModel) chatURL(baseURL, modelName string) string {
	suffix := h.baseModel.URLSuffix.Chat
	if huaweiCloudUsesV1Chat(modelName) {
		if h.baseModel.URLSuffix.AsyncChat != "" {
			suffix = h.baseModel.URLSuffix.AsyncChat
		} else {
			suffix = "v1/chat/completions"
		}
	}
	return baseURL + "/" + strings.TrimPrefix(suffix, "/")
}

func huaweiCloudApplyChatConfig(req map[string]any, modelName string, chatModelConfig *ChatConfig) {
	if chatModelConfig == nil {
		return
	}
	if chatModelConfig.Temperature != nil {
		req["temperature"] = *chatModelConfig.Temperature
	}
	if chatModelConfig.TopP != nil {
		req["top_p"] = *chatModelConfig.TopP
	}
	if chatModelConfig.Stop != nil && len(*chatModelConfig.Stop) > 0 {
		req["stop"] = *chatModelConfig.Stop
	}
	if chatModelConfig.Thinking == nil || !huaweiCloudSupportsThinkingToggle(modelName) {
		return
	}

	thinkingType := "disabled"
	if *chatModelConfig.Thinking {
		thinkingType = "enabled"
		if huaweiCloudIsDeepSeekV4(modelName) {
			effort := "high"
			if chatModelConfig.Effort != nil && *chatModelConfig.Effort != "" {
				effort = *chatModelConfig.Effort
			}
			switch strings.ToLower(effort) {
			case "none", "low", "medium":
				thinkingType = "disabled"
			case "max":
				req["reasoning_effort"] = "max"
			default:
				req["reasoning_effort"] = "high"
			}
		}
	}

	req["thinking"] = map[string]interface{}{
		"type": thinkingType,
	}
}

func (h *HuaweiCloudModel) ChatWithMessages(ctx context.Context, modelName string, messages []Message, apiConfig *APIConfig, chatModelConfig *ChatConfig, modelUsage *common.ModelUsage) (*ChatResponse, error) {
	if err := h.baseModel.APIConfigCheck(apiConfig); err != nil {
		return nil, err
	}
	if modelName == "" {
		return nil, fmt.Errorf("model name is required")
	}
	if len(messages) == 0 {
		return nil, fmt.Errorf("messages is empty")
	}

	baseURLRegion := huaweiCloudRegionForModel(apiConfig, modelName)
	baseURLConfig := &APIConfig{Region: &baseURLRegion}
	baseURLConfig.BaseURL = apiConfig.BaseURL

	baseURL, err := h.baseModel.GetBaseURL(baseURLConfig)
	if err != nil {
		return nil, err
	}
	baseURL = strings.TrimSuffix(baseURL, "/")

	url := h.chatURL(baseURL, modelName)

	reqb := buildRequestBody(chatModelConfig, huaweiCloudChatModelName(modelName), messages, false)
	huaweiCloudApplyChatConfig(reqb, modelName, chatModelConfig)
	applyChatToolConfig(reqb, chatModelConfig)

	body, err := h.baseModel.doRequest(ctx, url, apiConfig, reqb, nonStreamCallTimeout)
	if err != nil {
		return nil, err
	}

	return HandleNonStreamingResponse(ctx, body, modelUsage, chatModelConfig, OpenAIParserConfig)
}

func (h *HuaweiCloudModel) ChatStreamlyWithSender(ctx context.Context, modelName string, messages []Message, apiConfig *APIConfig, chatModelConfig *ChatConfig, modelUsage *common.ModelUsage, sender func(*string, *string) error) error {
	if err := h.baseModel.APIConfigCheck(apiConfig); err != nil {
		return err
	}

	if sender == nil {
		return fmt.Errorf("sender is required")
	}
	if modelName == "" {
		return fmt.Errorf("model name is required")
	}
	if len(messages) == 0 {
		return fmt.Errorf("messages is empty")
	}

	baseURLRegion := huaweiCloudRegionForModel(apiConfig, modelName)
	baseURLConfig := &APIConfig{Region: &baseURLRegion}
	baseURLConfig.BaseURL = apiConfig.BaseURL

	baseURL, err := h.baseModel.GetBaseURL(baseURLConfig)
	if err != nil {
		return err
	}
	baseURL = strings.TrimSuffix(baseURL, "/")
	url := h.chatURL(baseURL, modelName)

	reqBody := buildRequestBody(chatModelConfig, huaweiCloudChatModelName(modelName), messages, true)
	if chatModelConfig != nil && chatModelConfig.Stream != nil && !*chatModelConfig.Stream {
		return fmt.Errorf("stream must be true in ChatStreamlyWithSender")
	}
	huaweiCloudApplyChatConfig(reqBody, modelName, chatModelConfig)
	if chatModelConfig != nil {
		chatModelConfig.ToolCallsResult = nil
		chatModelConfig.UsageResult = nil
	}
	reqBody["stream_options"] = map[string]interface{}{"include_usage": true}

	return h.baseModel.doStreamRequest(ctx, url, apiConfig, reqBody, streamCallTimeout, func(body io.ReadCloser) error {
		return HandleStreamingResponse(body, modelUsage, chatModelConfig, OpenAIParserConfig, sender)
	})
}

type huaweiCloudEmbeddingResponse struct {
	ID   string `json:"id"`
	Data []struct {
		Embedding []float64 `json:"embedding"`
		Index     *int      `json:"index"`
	} `json:"data"`
	Usage struct {
		PromptTokens int `json:"prompt_tokens"`
		TotalTokens  int `json:"total_tokens"`
	} `json:"usage"`
}

type huaweiCloudRerankResponse struct {
	ID      string `json:"id"`
	Results []struct {
		Index          int     `json:"index"`
		RelevanceScore float64 `json:"relevance_score"`
	} `json:"results"`
	Usage struct {
		PromptTokens int `json:"prompt_tokens"`
		TotalTokens  int `json:"total_tokens"`
	} `json:"usage"`
}

func (h *HuaweiCloudModel) Embed(ctx context.Context, modelName *string, request EmbedRequest, apiConfig *APIConfig, embeddingConfig *EmbeddingConfig, modelUsage *common.ModelUsage) ([]EmbeddingData, error) {
	if err := h.baseModel.APIConfigCheck(apiConfig); err != nil {
		return nil, err
	}
	if modelName == nil || *modelName == "" {
		return nil, fmt.Errorf("model name is required")
	}
	if len(request.Texts) == 0 {
		return []EmbeddingData{}, nil
	}

	baseURLRegion := huaweiCloudRegion(apiConfig)
	baseURLConfig := &APIConfig{Region: &baseURLRegion}
	baseURLConfig.BaseURL = apiConfig.BaseURL

	baseURL, err := h.baseModel.GetBaseURL(baseURLConfig)
	if err != nil {
		return nil, err
	}
	baseURL = strings.TrimSuffix(baseURL, "/")
	url := joinURL(baseURL, h.baseModel.URLSuffix.Embedding)

	reqBody := map[string]interface{}{
		"model":           *modelName,
		"input":           request.Texts,
		"encoding_format": "float",
	}

	jsonData, err := json.Marshal(reqBody)
	if err != nil {
		return nil, fmt.Errorf("failed to marshal request: %w", err)
	}

	ctx, cancel := context.WithTimeout(ctx, nonStreamCallTimeout)
	defer cancel()

	req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, bytes.NewBuffer(jsonData))
	if err != nil {
		return nil, fmt.Errorf("failed to create request: %w", err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", huaweiCloudAuthorization(*apiConfig.ApiKey))

	resp, err := h.baseModel.httpClient.Do(req)
	if err != nil {
		return nil, fmt.Errorf("failed to send request: %w", err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return nil, fmt.Errorf("failed to read response: %w", err)
	}
	if resp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("huawei cloud embedding API error: status %d, body: %s", resp.StatusCode, string(body))
	}

	var parsed huaweiCloudEmbeddingResponse
	if err = json.Unmarshal(body, &parsed); err != nil {
		return nil, fmt.Errorf("failed to decode response: %w", err)
	}
	if len(parsed.Data) != len(request.Texts) {
		return nil, fmt.Errorf("expected %d embeddings, got %d", len(request.Texts), len(parsed.Data))
	}

	embeddings := make([]EmbeddingData, len(request.Texts))
	seen := make([]bool, len(request.Texts))
	for _, item := range parsed.Data {
		if item.Index == nil {
			return nil, fmt.Errorf("missing index field in embedding item")
		}
		idx := *item.Index
		if idx < 0 || idx >= len(request.Texts) {
			return nil, fmt.Errorf("embedding index %d out of range", idx)
		}
		if seen[idx] {
			return nil, fmt.Errorf("duplicate embedding index %d", idx)
		}
		if len(item.Embedding) == 0 {
			return nil, fmt.Errorf("empty embedding at index %d", idx)
		}
		seen[idx] = true
		embeddings[idx] = EmbeddingData{
			Embedding: item.Embedding,
			Index:     idx,
		}
	}

	for i, ok := range seen {
		if !ok {
			return nil, fmt.Errorf("missing embedding index %d", i)
		}
	}
	recordResponseUsage(modelUsage, parsed.ID, &TokenUsage{
		PromptTokens: parsed.Usage.PromptTokens,
		TotalTokens:  parsed.Usage.TotalTokens,
	}, "embedding")

	return embeddings, nil
}

func (h *HuaweiCloudModel) Rerank(ctx context.Context, modelName *string, request RerankRequest, apiConfig *APIConfig, rerankConfig *RerankConfig, modelUsage *common.ModelUsage) (*RerankResponse, error) {
	if err := h.baseModel.APIConfigCheck(apiConfig); err != nil {
		return nil, err
	}
	if modelName == nil || *modelName == "" {
		return nil, fmt.Errorf("model name is required")
	}

	documents := request.Documents
	query := request.Query

	if query == "" {
		return nil, fmt.Errorf("query is required")
	}
	if len(documents) == 0 {
		return &RerankResponse{}, nil
	}

	baseURLRegion := huaweiCloudRegion(apiConfig)
	baseURLConfig := &APIConfig{Region: &baseURLRegion}
	baseURLConfig.BaseURL = apiConfig.BaseURL

	baseURL, err := h.baseModel.GetBaseURL(baseURLConfig)
	if err != nil {
		return nil, err
	}
	baseURL = strings.TrimSuffix(baseURL, "/")
	url := joinURL(baseURL, h.baseModel.URLSuffix.Rerank)

	reqBody := map[string]interface{}{
		"model":     *modelName,
		"query":     query,
		"documents": documents,
	}

	jsonData, err := json.Marshal(reqBody)
	if err != nil {
		return nil, fmt.Errorf("failed to marshal request: %w", err)
	}

	ctx, cancel := context.WithTimeout(ctx, nonStreamCallTimeout)
	defer cancel()

	req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, bytes.NewBuffer(jsonData))
	if err != nil {
		return nil, fmt.Errorf("failed to create request: %w", err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", huaweiCloudAuthorization(*apiConfig.ApiKey))

	resp, err := h.baseModel.httpClient.Do(req)
	if err != nil {
		return nil, fmt.Errorf("failed to send request: %w", err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return nil, fmt.Errorf("failed to read response: %w", err)
	}
	if resp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("huawei cloud rerank API error: status %d, body: %s", resp.StatusCode, string(body))
	}

	var parsed huaweiCloudRerankResponse
	if err = json.Unmarshal(body, &parsed); err != nil {
		return nil, fmt.Errorf("failed to decode response: %w", err)
	}

	limit := len(parsed.Results)
	if rerankConfig != nil && rerankConfig.TopN > 0 && rerankConfig.TopN < limit {
		limit = rerankConfig.TopN
	}

	result := &RerankResponse{
		Data: make([]RerankResult, 0, limit),
	}
	for i := 0; i < limit; i++ {
		item := parsed.Results[i]
		if item.Index < 0 || item.Index >= len(documents) {
			return nil, fmt.Errorf("rerank index %d out of range", item.Index)
		}
		result.Data = append(result.Data, RerankResult{
			Index:          item.Index,
			RelevanceScore: item.RelevanceScore,
		})
	}
	recordResponseUsage(modelUsage, parsed.ID, &TokenUsage{
		PromptTokens: parsed.Usage.PromptTokens,
		TotalTokens:  parsed.Usage.TotalTokens,
	}, "rerank")

	return result, nil
}

func (h *HuaweiCloudModel) TranscribeAudio(ctx context.Context, modelName *string, file *string, apiConfig *APIConfig, asrConfig *ASRConfig, modelUsage *common.ModelUsage) (*ASRResponse, error) {
	return nil, fmt.Errorf("%s: no such method: TranscribeAudio", h.Name())
}

func (h *HuaweiCloudModel) TranscribeAudioWithSender(ctx context.Context, modelName *string, file *string, apiConfig *APIConfig, asrConfig *ASRConfig, modelUsage *common.ModelUsage, sender func(*string, *string) error) error {
	return fmt.Errorf("%s: no such method: TranscribeAudioWithSender", h.Name())
}

func (h *HuaweiCloudModel) AudioSpeech(ctx context.Context, modelName *string, audioContent *string, apiConfig *APIConfig, ttsConfig *TTSConfig, modelUsage *common.ModelUsage) (*TTSResponse, error) {
	return nil, fmt.Errorf("%s: no such method: AudioSpeech", h.Name())
}

func (h *HuaweiCloudModel) AudioSpeechWithSender(ctx context.Context, modelName *string, audioContent *string, apiConfig *APIConfig, ttsConfig *TTSConfig, modelUsage *common.ModelUsage, sender func(*string, *string) error) error {
	return fmt.Errorf("%s: no such method: AudioSpeechWithSender", h.Name())
}

func (h *HuaweiCloudModel) OCRFile(ctx context.Context, modelName *string, content []byte, url *string, apiConfig *APIConfig, ocrConfig *OCRConfig, modelUsage *common.ModelUsage) (*OCRFileResponse, error) {
	return nil, fmt.Errorf("%s: no such method: OCRFile", h.Name())
}

func (h *HuaweiCloudModel) ParseFile(ctx context.Context, modelName *string, content []byte, url *string, apiConfig *APIConfig, parseFileConfig *ParseFileConfig, modelUsage *common.ModelUsage) (*ParseFileResponse, error) {
	return nil, fmt.Errorf("%s: no such method: ParseFile", h.Name())
}

func (h *HuaweiCloudModel) ListModels(ctx context.Context, apiConfig *APIConfig) ([]ListModelResponse, error) {
	if err := h.baseModel.APIConfigCheck(apiConfig); err != nil {
		return nil, err
	}

	baseURLRegion := huaweiCloudRegion(apiConfig)
	baseURLConfig := &APIConfig{Region: &baseURLRegion}
	baseURLConfig.BaseURL = apiConfig.BaseURL

	baseURL, err := h.baseModel.GetBaseURL(baseURLConfig)
	if err != nil {
		return nil, err
	}
	baseURL = strings.TrimSuffix(baseURL, "/")
	url := joinURL(baseURL, h.baseModel.URLSuffix.Models)

	ctx, cancel := context.WithTimeout(ctx, nonStreamCallTimeout)
	defer cancel()

	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
	if err != nil {
		return nil, fmt.Errorf("failed to create request: %w", err)
	}
	req.Header.Set("Authorization", huaweiCloudAuthorization(*apiConfig.ApiKey))

	resp, err := h.baseModel.httpClient.Do(req)
	if err != nil {
		return nil, fmt.Errorf("failed to send request: %w", err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return nil, fmt.Errorf("failed to read response: %w", err)
	}
	if resp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("huawei cloud models API error: status %d, body: %s", resp.StatusCode, string(body))
	}

	var parsed struct {
		Data []ModelListItem `json:"data"`
	}
	if err = json.Unmarshal(body, &parsed); err != nil {
		return nil, fmt.Errorf("failed to decode response: %w", err)
	}

	if len(parsed.Data) == 0 {
		return nil, fmt.Errorf("no models in response")
	}
	return ParseListModel(ModelList{Models: parsed.Data}), nil
}

func (h *HuaweiCloudModel) Balance(ctx context.Context, apiConfig *APIConfig) (map[string]interface{}, error) {
	return nil, fmt.Errorf("%s: no such method: Balance", h.Name())
}

func (h *HuaweiCloudModel) CheckConnection(ctx context.Context, apiConfig *APIConfig) error {
	_, err := h.ListModels(ctx, apiConfig)
	return err
}

func (h *HuaweiCloudModel) ListTasks(ctx context.Context, apiConfig *APIConfig) ([]ListTaskStatus, error) {
	return nil, fmt.Errorf("%s: no such method: ListTasks", h.Name())
}

func (h *HuaweiCloudModel) ShowTask(ctx context.Context, taskID string, apiConfig *APIConfig) (*TaskResponse, error) {
	return nil, fmt.Errorf("%s: no such method: ShowTask", h.Name())
}

func (h *HuaweiCloudModel) Decide(ctx context.Context, modelName *string, request *DecideRequest, apiConfig *APIConfig, modelUsage *common.ModelUsage) (*DecideResponse, error) {
	return nil, fmt.Errorf("%s: no such method: Decide", h.Name())
}