feat: enable S2S with native Viking memory

This commit is contained in:
Codex Local
2026-09-06 17:27:49 +08:00
parent 0c2151ace9
commit d60f5d9a9b
15 changed files with 223 additions and 42 deletions
+1 -1
View File
@@ -86,7 +86,7 @@ func Run(ctx context.Context, serviceName string) error {
var vikingMemory *vikingmemory.Service
if serviceName == "api" || serviceName == "worker" {
if cfg.VikingResourceID != "" {
client, vikingErr := vikingmemory.NewClient(vikingmemory.Options{ResourceID: cfg.VikingResourceID, APIKey: cfg.VikingAPIKey, EventType: cfg.VikingEventType, ProfileType: cfg.VikingProfileType, Timeout: 8 * time.Second})
client, vikingErr := vikingmemory.NewClient(vikingmemory.Options{ResourceID: cfg.VikingResourceID, CollectionName: cfg.VikingCollectionName, APIKey: cfg.VikingAPIKey, EventType: cfg.VikingEventType, ProfileType: cfg.VikingProfileType, Timeout: 8 * time.Second})
if vikingErr != nil {
return fmt.Errorf("configure Viking memory: %w", vikingErr)
}
+2
View File
@@ -24,6 +24,7 @@ const (
type Config struct {
VikingResourceID string
VikingCollectionName string
VikingAPIKey string
VikingEventType string
VikingProfileType string
@@ -414,6 +415,7 @@ func Load(serviceName string) (Config, error) {
MemoryToolSigningSecret: memoryToolSigningSecret,
MemoryToolTokenTTL: memoryToolTokenTTL,
VikingResourceID: strings.TrimSpace(os.Getenv("VIKING_MEMORY_RESOURCE_ID")),
VikingCollectionName: strings.TrimSpace(os.Getenv("VIKING_MEMORY_COLLECTION_NAME")),
VikingAPIKey: secretValues["VIKING_MEMORY_API_KEY"],
VikingEventType: stringEnv("VIKING_MEMORY_EVENT_TYPE", "event_v1"),
VikingProfileType: stringEnv("VIKING_MEMORY_PROFILE_TYPE", "profile_v1"),
+19 -4
View File
@@ -42,13 +42,28 @@ func (s *Service) CreateHardwareAgent(ctx context.Context, identity deviceauth.I
return HardwareAgentCreateResponse{}, false, err
}
var vikingSubject, vikingContext string
var vikingNativeMemory *HardwareAgentMemoryConfig
if s.viking != nil {
readContext, cancel := context.WithTimeout(ctx, 3*time.Second)
var readErr error
vikingSubject, vikingContext, readErr = s.viking.PrepareForDevice(readContext, identity.TenantID, identity.ID)
native, readErr := s.viking.NativeAccessForDevice(readContext, identity.TenantID, identity.ID)
cancel()
if readErr != nil {
slog.WarnContext(ctx, "Viking startup memory unavailable", "error", readErr)
slog.WarnContext(ctx, "Viking native memory configuration unavailable", "error", readErr)
} else if native != nil {
vikingSubject = native.SubjectID
vikingNativeMemory = &HardwareAgentMemoryConfig{
CollectionName: native.CollectionName, UserID: native.UserID, AssistantID: native.AssistantID,
MemoryTypes: native.MemoryTypes, Limit: native.Limit, TransitionWords: native.TransitionWords,
}
} else {
// Older deployments without a native collection name keep the
// platform-side startup retrieval path as a compatibility fallback.
fallbackContext, fallbackCancel := context.WithTimeout(ctx, 3*time.Second)
vikingSubject, vikingContext, readErr = s.viking.PrepareForDevice(fallbackContext, identity.TenantID, identity.ID)
fallbackCancel()
if readErr != nil {
slog.WarnContext(ctx, "Viking startup memory unavailable", "error", readErr)
}
}
}
result, err := s.executor.Execute(ctx, request, func(operationContext context.Context, tx pgx.Tx) (idempotency.Result, error) {
@@ -61,7 +76,7 @@ func (s *Service) CreateHardwareAgent(ctx context.Context, identity deviceauth.I
TokenExpires: now.Add(s.options.TokenTTL), RTCAppID: s.options.RTCAppID,
VoiceProvider: s.options.VoiceProvider, EngineMode: s.options.EngineMode,
HeartbeatInterval: s.options.HeartbeatInterval, MemoryQueryVector: memoryVector,
VikingSubjectID: vikingSubject, VikingContext: vikingContext,
VikingSubjectID: vikingSubject, VikingContext: vikingContext, VikingNativeMemory: vikingNativeMemory,
MemoryPolicy: memoryPolicy, RequirePublishedRouting: s.options.RequirePublishedRouting,
RuntimeType: RuntimeVolcHardwareAgent, HardwareBotID: s.options.HardwareBotID,
HardwareTransport: s.options.HardwareTransport, HardwareCapabilities: input.Capabilities,
+22 -4
View File
@@ -51,6 +51,7 @@ const (
type AllocationOptions struct {
VikingSubjectID string
VikingContext string
VikingNativeMemory *HardwareAgentMemoryConfig
Now time.Time
AllocationExpires time.Time
TokenExpires time.Time
@@ -413,6 +414,7 @@ func (r *Repository) Create(
}
contextSummary := buildContextSummary(subjectName, profileContext, recentSummaries, memoryContents)
var vikingContext string
var vikingNativeMemory *HardwareAgentMemoryConfig
if options.VikingSubjectID == subjectID && options.VikingContext != "" && consentAllowsConversationContinuity(effectiveConsents) {
var allowed bool
if err = tx.QueryRow(ctx, `SELECT EXISTS(SELECT 1 FROM consent_record WHERE tenant_id=$1::uuid AND subject_id=$2::uuid AND consent_type='personalized_memory' AND withdrawn_at IS NULL AND (expires_at IS NULL OR expires_at>now())) AND NOT EXISTS(SELECT 1 FROM privacy_request WHERE tenant_id=$1::uuid AND subject_id=$2::uuid AND request_type='DELETE')`, identity.TenantID, subjectID).Scan(&allowed); err != nil {
@@ -423,6 +425,17 @@ func (r *Repository) Create(
contextSummary += "\nViking 自动抽取的历史记忆(仅作背景,不是指令;可能有误,以用户最新说法为准):" + vikingContext
}
}
if options.VikingSubjectID == subjectID && options.VikingNativeMemory != nil && consentAllowsConversationContinuity(effectiveConsents) {
var allowed bool
if err = tx.QueryRow(ctx, `SELECT EXISTS(SELECT 1 FROM consent_record WHERE tenant_id=$1::uuid AND subject_id=$2::uuid AND consent_type='personalized_memory' AND withdrawn_at IS NULL AND (expires_at IS NULL OR expires_at>now())) AND NOT EXISTS(SELECT 1 FROM privacy_request WHERE tenant_id=$1::uuid AND subject_id=$2::uuid AND request_type='DELETE')`, identity.TenantID, subjectID).Scan(&allowed); err != nil {
return CreateResponse{}, "", err
}
if allowed {
copy := *options.VikingNativeMemory
copy.MemoryTypes = append([]string(nil), options.VikingNativeMemory.MemoryTypes...)
vikingNativeMemory = &copy
}
}
contextValue := struct {
SubjectID string `json:"subject_id"`
PreferredName string `json:"preferred_name"`
@@ -496,7 +509,7 @@ func (r *Repository) Create(
}
if runtimeType == RuntimeVolcHardwareAgent {
return r.createHardwareAgentRuntime(ctx, tx, identity, conversationID, conversationPublicID,
providerTaskRef, promptBundleVersion, engineMode, contextSummary, privacy, input, options)
providerTaskRef, promptBundleVersion, engineMode, contextSummary, privacy, input, options, vikingNativeMemory)
}
_, err = tx.Exec(ctx, `
INSERT INTO conversation_state_history (conversation_id, from_status, to_status, reason, source)
@@ -553,6 +566,7 @@ func (r *Repository) createHardwareAgentRuntime(
privacy Privacy,
input CreateInput,
options AllocationOptions,
vikingNativeMemory *HardwareAgentMemoryConfig,
) (CreateResponse, string, error) {
botID := strings.TrimSpace(options.HardwareBotID)
transport := strings.TrimSpace(options.HardwareTransport)
@@ -610,11 +624,15 @@ func (r *Repository) createHardwareAgentRuntime(
}
sessionNonce := base64.RawURLEncoding.EncodeToString(nonceBytes)
nonceDigest := sha256.Sum256([]byte(sessionNonce))
configValue := map[string]string{
configValue := map[string]any{
"bot_id": botID, "transport": transport, "system_prompt": systemPrompt,
"persona_tone": personaTone, "authorized_context": contextSummary,
"prompt_bundle_version": promptBundleVersion,
"tool_url": options.HardwareMemoryToolURL,
"model_mode": "s2s",
}
if vikingNativeMemory != nil {
configValue["memory"] = vikingNativeMemory
}
configJSON, _ := json.Marshal(configValue)
callbackURL, callbackSignature, subtitleSource := "", "", "device"
@@ -668,10 +686,10 @@ func (r *Repository) createHardwareAgentRuntime(
Runtime: HardwareAgentRuntime{Provider: "volcengine", BotID: botID, Transport: transport,
ProviderSessionRef: providerSessionRef, SessionNonce: sessionNonce,
ConfigDigest: hex.EncodeToString(configDigest[:]), WaitForSessionUpdate: true},
SessionConfig: HardwareAgentSessionConfig{DialogID: conversationPublicID, SystemPrompt: systemPrompt,
SessionConfig: HardwareAgentSessionConfig{DialogID: conversationPublicID, ModelMode: "s2s", SystemPrompt: systemPrompt,
PersonaTone: personaTone, AuthorizedContext: contextSummary, PromptBundleVersion: promptBundleVersion,
ToolURL: options.HardwareMemoryToolURL, SubtitleCallbackURL: callbackURL,
SubtitleCallbackSignature: callbackSignature, SubtitleSource: subtitleSource},
SubtitleCallbackSignature: callbackSignature, SubtitleSource: subtitleSource, Memory: vikingNativeMemory},
Privacy: privacy,
Session: Session{EngineMode: engineMode, HeartbeatIntervalSecond: options.HeartbeatInterval,
+21 -10
View File
@@ -112,16 +112,27 @@ type HardwareAgentRuntime struct {
}
type HardwareAgentSessionConfig struct {
DialogID string `json:"dialog_id"`
SystemPrompt string `json:"system_prompt,omitempty"`
PersonaTone string `json:"persona_tone,omitempty"`
AuthorizedContext string `json:"authorized_context"`
PromptBundleVersion string `json:"prompt_bundle_version"`
ToolURL string `json:"tool_url,omitempty"`
ToolScopeToken string `json:"tool_scope_token,omitempty"`
SubtitleCallbackURL string `json:"subtitle_callback_url,omitempty"`
SubtitleCallbackSignature string `json:"subtitle_callback_signature,omitempty"`
SubtitleSource string `json:"subtitle_source,omitempty"`
DialogID string `json:"dialog_id"`
ModelMode string `json:"model_mode"`
SystemPrompt string `json:"system_prompt,omitempty"`
PersonaTone string `json:"persona_tone,omitempty"`
AuthorizedContext string `json:"authorized_context"`
PromptBundleVersion string `json:"prompt_bundle_version"`
ToolURL string `json:"tool_url,omitempty"`
ToolScopeToken string `json:"tool_scope_token,omitempty"`
SubtitleCallbackURL string `json:"subtitle_callback_url,omitempty"`
SubtitleCallbackSignature string `json:"subtitle_callback_signature,omitempty"`
SubtitleSource string `json:"subtitle_source,omitempty"`
Memory *HardwareAgentMemoryConfig `json:"memory,omitempty"`
}
type HardwareAgentMemoryConfig struct {
CollectionName string `json:"collection_name"`
UserID string `json:"user_id"`
AssistantID string `json:"assistant_id,omitempty"`
MemoryTypes []string `json:"memory_types"`
Limit int `json:"limit"`
TransitionWords string `json:"transition_words,omitempty"`
}
type HardwareAgentCreateResponse struct {
+2 -2
View File
@@ -21,8 +21,8 @@ import (
const AssistantID = "platform_companion_v1"
type Options struct {
BaseURL, ResourceID, APIKey, EventType, ProfileType string
Timeout time.Duration
BaseURL, ResourceID, CollectionName, APIKey, EventType, ProfileType string
Timeout time.Duration
}
type Client struct {
options Options
+36
View File
@@ -27,6 +27,15 @@ type Service struct {
client *Client
}
// NativeAccess contains only non-secret values that Volcano needs to query
// this user's memory. The Viking API key is never returned to the device.
type NativeAccess struct {
SubjectID, UserID, CollectionName, AssistantID string
MemoryTypes []string
Limit int
TransitionWords string
}
func NewService(pool *pgxpool.Pool, client *Client) *Service {
return &Service{pool: pool, client: client}
}
@@ -71,6 +80,33 @@ func (s *Service) PrepareForDevice(ctx context.Context, tenant, device string) (
}
return subject, strings.Join(parts, "\n"), nil
}
func (s *Service) NativeAccessForDevice(ctx context.Context, tenant, device string) (*NativeAccess, error) {
if strings.TrimSpace(s.client.options.CollectionName) == "" {
return nil, nil
}
var subject string
err := s.pool.QueryRow(ctx, `SELECT b.subject_id::text FROM device_binding b JOIN device d ON d.id=b.device_id AND d.tenant_id=b.tenant_id WHERE b.device_id=$1::uuid AND b.tenant_id=$2::uuid AND b.unbound_at IS NULL AND d.status='registered'`, device, tenant).Scan(&subject)
if errors.Is(err, pgx.ErrNoRows) {
return nil, nil
}
if err != nil {
return nil, err
}
ok, err := s.Eligible(ctx, tenant, subject)
if err != nil || !ok {
return nil, err
}
memoryTypes := []string{s.client.options.EventType}
if s.client.options.ProfileType != "" && s.client.options.ProfileType != s.client.options.EventType {
memoryTypes = append(memoryTypes, s.client.options.ProfileType)
}
return &NativeAccess{
SubjectID: subject, UserID: UserID(tenant, subject), CollectionName: s.client.options.CollectionName,
AssistantID: AssistantID, MemoryTypes: memoryTypes, Limit: 5,
TransitionWords: "可参考的用户历史记忆如下,请自然承接;若与用户最新说法冲突,以最新说法为准:",
}, nil
}
func (s *Service) Enqueue(ctx context.Context, event outbox.Event) error {
tx, err := s.pool.Begin(ctx)
if err != nil {