docs: Updated API documentation, added examples and fields, and adjusted responses and parameters.

This commit is contained in:
begoniezhao
2025-08-12 15:35:24 +08:00
committed by lyingbug
parent a347abf829
commit 705ea7a52c
3 changed files with 1488 additions and 803 deletions

File diff suppressed because it is too large Load Diff

View File

@@ -22,10 +22,10 @@ func NewEvaluationHandler(evaluationService interfaces.EvaluationService) *Evalu
// EvaluationRequest contains parameters for evaluation request
type EvaluationRequest struct {
DatasetID string `json:"dataset_id"` // ID of dataset to evaluate
EmbeddingModelID string `json:"embedding_id"` // ID of embedding model to use
ChatModelID string `json:"chat_id"` // ID of chat model to use
RerankModelID string `json:"rerank_id"` // ID of rerank model to use
DatasetID string `json:"dataset_id"` // ID of dataset to evaluate
KnowledgeBaseID string `json:"knowledge_base_id"` // ID of knowledge base to use
ChatModelID string `json:"chat_id"` // ID of chat model to use
RerankModelID string `json:"rerank_id"` // ID of rerank model to use
}
// Evaluation handles evaluation request
@@ -48,12 +48,12 @@ func (e *EvaluationHandler) Evaluation(c *gin.Context) {
return
}
logger.Infof(ctx, "Executing evaluation, tenant: %v, dataset: %s, embedding: %s, chat: %s, rerank: %s",
tenantID, request.DatasetID, request.EmbeddingModelID, request.ChatModelID, request.RerankModelID)
logger.Infof(ctx, "Executing evaluation, tenant: %v, dataset: %s, knowledge_base: %s, chat: %s, rerank: %s",
tenantID, request.DatasetID, request.KnowledgeBaseID, request.ChatModelID, request.RerankModelID)
task, err := e.evaluationService.Evaluation(ctx,
request.DatasetID,
request.EmbeddingModelID,
request.KnowledgeBaseID,
request.ChatModelID,
request.RerankModelID,
)

View File

@@ -9,7 +9,7 @@ import (
// EvaluationService defines operations for evaluation tasks
type EvaluationService interface {
// Evaluation starts a new evaluation task
Evaluation(ctx context.Context, datasetID string, embeddingModelID string,
Evaluation(ctx context.Context, datasetID string, knowledgeBaseID string,
chatModelID string, rerankModelID string,
) (*types.EvaluationDetail, error)
// EvaluationResult retrieves evaluation result by task ID