ai-agent/internal/ai/runtime/executor/context_builders.go

package executor

import (
	"context"
	"strings"

	"cs-agent/internal/ai/runtime/internal/impl/adapter"
	"cs-agent/internal/ai/runtime/internal/impl/callbacks"
	"cs-agent/internal/ai/runtime/internal/impl/retrievers"
	"cs-agent/internal/pkg/utils"

	"github.com/cloudwego/eino/schema"
)

func buildRunMessages(ctx context.Context, req RunInput, summary *RunResult, collector *callbacks.RuntimeTraceCollector) []*schema.Message {
	history := adapter.BuildHistoryMessages(req.Conversation.ID, req.UserMessage.ID, 12)
	if summary != nil {
		summary.HistoryMessageCount = len(history.Messages)
	}
	if collector != nil {
		collector.Data.Input.HistoryMessageCount = len(history.Messages)
		collector.Data.Input.KnowledgeBaseIDs = utils.SplitInt64s(req.AIAgent.KnowledgeIDs)
		collector.Data.Input.CurrentUserMessagePreview = preview(req.UserMessage.Content, 120)
	}
	messages := make([]*schema.Message, 0, len(history.Messages)+3)
	messages = append(messages, history.Messages...)
	decision := appendRetrievedContext(ctx, req, summary, collector, &messages)
	if strings.TrimSpace(decision.FallbackReply) != "" {
		if summary != nil {
			summary.ReplyText = decision.FallbackReply
		}
		return messages
	}
	messages = append(messages, schema.UserMessage(strings.TrimSpace(req.UserMessage.Content)))
	return messages
}

func appendRetrievedContext(ctx context.Context, req RunInput, summary *RunResult, collector *callbacks.RuntimeTraceCollector, messages *[]*schema.Message) knowledgeGuardDecision {
	if messages == nil {
		return knowledgeGuardDecision{}
	}
	retriever := retrievers.NewKnowledgeRetriever(req.AIAgent)
	retrieveOptions := retrievers.DefaultKnowledgeRetrieveOptions()
	retrieveOptions.QueryPreview = preview(req.UserMessage.Content, 120)
	retrieveResult, retrieveErr := retriever.RetrieveContextByOptions(ctx, retrieveOptions, strings.TrimSpace(req.UserMessage.Content))
	if retrieveErr != nil || retrieveResult == nil {
		return buildKnowledgeUnavailableDecision(req.AIAgent, retriever.KnowledgeBaseIDs())
	}
	if summary != nil {
		summary.RetrieverCount = len(retrieveResult.Hits)
	}
	if collector != nil {
		collector.SetRetrieverSummary(retrieveResult.TraceSummary)
		collector.AddRetrieverItems(retrieveResult.TraceItems)
	}
	decision := buildKnowledgeGuardDecision(req.AIAgent, retrieveResult)
	if len(decision.Instructions) > 0 {
		*messages = append(*messages, decision.Instructions...)
	}
	if strings.TrimSpace(retrieveResult.ContextText) != "" {
		*messages = append(*messages, schema.SystemMessage(retrieveResult.ContextText))
	}
	return decision
}