feat(agent): enhance suggested questions API with tag scopes

Update the SuggestedQuestionsRequest to include TagScopes for better filtering of knowledge items based on their parent knowledge bases. Modify related API documentation and frontend interfaces to accommodate the new structure. Ensure backend services handle the new tag scope logic correctly, including tests for the updated functionality.
This commit is contained in:
wizardchen
2026-07-17 10:16:58 +08:00
committed by lyingbug
parent c21c34b3c0
commit eedd7d4641
34 changed files with 1041 additions and 338 deletions
@@ -4,6 +4,7 @@ import (
"context"
"net/http"
"net/http/httptest"
"net/url"
"testing"
apperrors "github.com/Tencent/WeKnora/internal/errors"
@@ -11,21 +12,24 @@ import (
"github.com/Tencent/WeKnora/internal/types"
"github.com/Tencent/WeKnora/internal/types/interfaces"
"github.com/gin-gonic/gin"
"github.com/stretchr/testify/require"
)
type suggestedQuestionsAgentService struct {
interfaces.CustomAgentService
err error
err error
tagScopes []types.TagScope
}
func (s *suggestedQuestionsAgentService) GetSuggestedQuestions(
context.Context,
string,
[]string,
[]string,
[]string,
int,
_ context.Context,
_ string,
_ []string,
_ []string,
tagScopes []types.TagScope,
_ int,
) ([]types.SuggestedQuestion, error) {
s.tagScopes = tagScopes
return nil, s.err
}
@@ -47,3 +51,44 @@ func TestGetSuggestedQuestionsPreservesAppErrorStatus(t *testing.T) {
t.Fatalf("status = %d, want %d, body=%s", rec.Code, http.StatusForbidden, rec.Body.String())
}
}
func TestGetSuggestedQuestionsParsesScopedTags(t *testing.T) {
gin.SetMode(gin.TestMode)
r := gin.New()
r.Use(middleware.ErrorHandler())
service := &suggestedQuestionsAgentService{}
h := &CustomAgentHandler{service: service}
r.GET("/agents/:id/suggested-questions", h.GetSuggestedQuestions)
rawScopes := `[{"knowledge_base_id":"kb-1","tag_ids":["tag-1","tag-2"]}]`
rec := httptest.NewRecorder()
req := httptest.NewRequest(
http.MethodGet,
"/agents/agent-1/suggested-questions?tag_scopes="+url.QueryEscape(rawScopes),
nil,
)
r.ServeHTTP(rec, req)
require.Equal(t, http.StatusOK, rec.Code, rec.Body.String())
require.Equal(t, []types.TagScope{{KnowledgeBaseID: "kb-1", TagIDs: []string{"tag-1", "tag-2"}}}, service.tagScopes)
}
func TestGetSuggestedQuestionsRejectsInvalidScopedTags(t *testing.T) {
gin.SetMode(gin.TestMode)
r := gin.New()
r.Use(middleware.ErrorHandler())
h := &CustomAgentHandler{service: &suggestedQuestionsAgentService{}}
r.GET("/agents/:id/suggested-questions", h.GetSuggestedQuestions)
rec := httptest.NewRecorder()
req := httptest.NewRequest(
http.MethodGet,
"/agents/agent-1/suggested-questions?tag_scopes="+url.QueryEscape("not-json"),
nil,
)
r.ServeHTTP(rec, req)
require.Equal(t, http.StatusBadRequest, rec.Code, rec.Body.String())
}