Tencent/WeKnora · error

failed to init retrieve engine: %w

Error message

failed to init retrieve engine: %w

What it means

Thrown when retriever.CreateRetrieveEngineForKB fails to build a retrieve engine bound to the KB's vector store while indexing the summary chunk. Typically an invalid/expired vector-store configuration or provider connectivity issue.

Source

Thrown at internal/application/service/knowledge_process.go:1342

			summaryErr = err
			return fmt.Errorf("failed to create summary chunk: %w", err)
		}

		// Index summary chunk
		tenantInfo, err := s.tenantRepo.GetTenantByID(ctx, payload.TenantID)
		if err != nil {
			logger.Errorf(ctx, "Failed to get tenant info: %v", err)
			summaryErr = err
			return fmt.Errorf("failed to get tenant info: %w", err)
		}
		ctx = context.WithValue(ctx, types.TenantInfoContextKey, tenantInfo)

		retrieveEngine, err := retriever.CreateRetrieveEngineForKB(
			ctx, s.retrieveEngine, s.ownership, tenantInfo.ID, kb.VectorStoreID)
		if err != nil {
			logger.Errorf(ctx, "Failed to init retrieve engine: %v", err)
			summaryErr = err
			return fmt.Errorf("failed to init retrieve engine: %w", err)
		}

		embeddingModel, err := s.modelService.GetEmbeddingModel(ctx, kb.EmbeddingModelID)
		if err != nil {
			logger.Errorf(ctx, "Failed to get embedding model: %v", err)
			summaryErr = err
			return fmt.Errorf("failed to get embedding model: %w", err)
		}

		indexInfo := []*types.IndexInfo{{
			Content:         summaryChunk.Content,
			SourceID:        summaryChunk.ID,
			SourceType:      types.ChunkSourceType,
			ChunkID:         summaryChunk.ID,
			KnowledgeID:     knowledge.ID,
			KnowledgeBaseID: knowledge.KnowledgeBaseID,
			IsEnabled:       true,
		}}

View on GitHub (pinned to 988cbb0330)

Solutions

1. Verify the knowledge base's VectorStoreID is valid and the store is reachable
2. Check vector store provider credentials and network access from workers
3. Retry summary generation once the vector store is healthy

When it happens

Trigger: Thrown at internal/application/service/knowledge_process.go:1342 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Tencent/WeKnora@988cbb0330 (2026-09-02). Data as JSON: /api/errors/2798e5b8f7fc5c98. Report an issue: GitHub.