Merge pull request #2093 from milvus-io/preview

ThyeeZz · web-flow · commit 7e9c3a02743e · 2025-08-29T17:31:02.000+08:00
Preview
diff --git a/.github/workflows/preview_aws.yml b/.github/workflows/preview_aws.yml
@@ -75,7 +75,7 @@ jobs:
             --build-arg MSERVICE_URL=${{ secrets.MSERVICE_URL }} \
             --build-arg CMS_BASE_URL=${{ secrets.CMS_BASE_URL }} \
             --build-arg REPO_STATICS_KEY=${{ secrets.REPO_STATICS_KEY }} \
-            --build-arg INKEEP_API_KEY=${{ secrets.INKEEP_API_KEY }} \
+            --build-arg INKEEP_API_KEY=${{ secrets.INKEEP_API_KEY_DEV }} \
             --build-arg IS_PREVIEW=${{ secrets.PREVIEW_SITE }} \
             -t milvusdb/milvus-io-dev:${{ steps.generate-tag-name.outputs.docker_tag }}
             docker push milvusdb/milvus-io-dev:${{ steps.generate-tag-name.outputs.docker_tag }}
diff --git a/src/hooks/use-inkeep-settings.ts b/src/hooks/use-inkeep-settings.ts
@@ -10,6 +10,8 @@ import {
   provideAnswerConfidenceSchema,
   salesSignalType,
   detectedSalesSignal,
+  supportSignalType,
+  detectedSupportSignal,
 } from '@/utils/inkeep';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { CONTACT_SALES_URL } from '@/consts/externalLinks';
@@ -103,59 +105,97 @@ export const useInkeepSettings = ({
       'Pharse Match',
     ],
     getTools: () => [
+      // {
+      //   type: 'function',
+      //   function: {
+      //     name: 'provideAnswerConfidence',
+      //     description:
+      //       'Determine how confident the AI assistant was and whether or not to escalate to humans.',
+      //     parameters: zodToJsonSchema(provideAnswerConfidenceSchema),
+      //   },
+      //   renderMessageButtons: ({ args }) => {
+      //     const confidence = args.answerConfidence;
+      //     if (['not_confident', 'no_sources', 'other'].includes(confidence)) {
+      //       return [
+      //         {
+      //           label: 'New Issue',
+      //           icon: { builtIn: 'IoHelpBuoyOutline' },
+      //           action: {
+      //             type: 'open_link',
+      //             url: 'https://github.com/milvus-io/milvus/issues',
+      //           },
+      //         },
+      //       ];
+      //     }
+      //     return [];
+      //   },
+      // } as ToolFunction<{
+      //   answerConfidence: string;
+      //   explanation: string;
+      // }>,
       {
         type: 'function',
         function: {
-          name: 'provideAnswerConfidence',
+          name: 'detectSalesSignal',
           description:
-            'Determine how confident the AI assistant was and whether or not to escalate to humans.',
-          parameters: zodToJsonSchema(provideAnswerConfidenceSchema),
+            'Identify when users express interest in potentially purchasing a product.',
+          parameters: zodToJsonSchema(detectedSalesSignal),
         },
         renderMessageButtons: ({ args }) => {
-          const confidence = args.answerConfidence;
-          if (['not_confident', 'no_sources', 'other'].includes(confidence)) {
+          // If any valid sales signal is detected, show a demo scheduling option
+          if (args.type && validSalesSignalTypes.includes(args.type)) {
             return [
               {
-                label: 'New Issue',
-                icon: { builtIn: 'IoHelpBuoyOutline' },
+                label: 'Contact Sales',
+                icon: { builtIn: 'LuCalendar' },
                 action: {
                   type: 'open_link',
-                  url: 'https://github.com/milvus-io/milvus/issues',
+                  url: `${CONTACT_SALES_URL}?contact_sales_traffic_source=milvusBot`,
                 },
               },
             ];
           }
           return [];
         },
-      } as ToolFunction<{
-        answerConfidence: string;
-        explanation: string;
-      }>,
+      } as ToolFunction<{ type: string }>,
       {
         type: 'function',
         function: {
-          name: 'detectSalesSignal',
+          name: 'detectSupportSignal',
           description:
-            'Identify when users express interest in potentially purchasing a product.',
-          parameters: zodToJsonSchema(detectedSalesSignal),
+            'Detect whether the user is requesting technical support or reporting an issue.',
+          parameters: zodToJsonSchema(detectedSupportSignal),
         },
         renderMessageButtons: ({ args }) => {
-          // If any valid sales signal is detected, show a demo scheduling option
-          if (args.type && validSalesSignalTypes.includes(args.type)) {
+          const signal = args?.type;
+          if (
+            [
+              'technical_issue',
+              'deployment_and_setup',
+              'system_operations',
+              'data_and_performance',
+              'integration_and_solutions',
+              'ai_low_confidence_or_docs_missing',
+              'direct_support_request',
+            ].includes(signal)
+          ) {
             return [
               {
                 label: 'Talk to Us',
-                icon: { builtIn: 'LuCalendar' },
+                icon: { builtIn: 'IoHelpBuoyOutline' },
                 action: {
                   type: 'open_link',
-                  url: `${CONTACT_SALES_URL}?contact_sales_traffic_source=milvusBot`,
+                  url: 'https://meetings.hubspot.com/chloe-williams1/milvus-office-hour',
                 },
               },
             ];
           }
           return [];
         },
-      } as ToolFunction<{ type: string }>,
+      } as ToolFunction<{
+        type: string;
+        explanation: string;
+      }>,
     ],
   };
 
diff --git a/src/utils/inkeep.ts b/src/utils/inkeep.ts
@@ -126,9 +126,86 @@ const detectedSalesSignal = z.object({
   type: salesSignalType,
 });
 
+const supportSignalType = z
+  .union([
+    z.literal('technical_issue').describe(`
+      The user is reporting a bug, error, crash, timeout, or unexpected system behavior that blocks or disrupts usage.
+      Examples:
+      • "Request timed out."
+      • "Fail to start with docker compose."
+      • "Pod crashes due to panics when syncing segment"
+      • "RootCoordClient message key not exist"
+      • "Failed to load collection."
+      • "Quota exceeded"
+      • "Fail to connect S3 with CA certs."
+      • "Inconsistent search results when topK is large."
+    `),
+
+    z.literal('deployment_and_setup').describe(`
+      The user is asking about how to install, configure, or tune Milvus.
+      Examples:
+      • "How do I configure Milvus to use external MinIO?"
+      • "How to upgrade from Milvus 2.4 to 2.6?"
+      • "How do I set resource limits for index nodes?"
+    `),
+
+    z.literal('system_operations').describe(`
+      The user is asking about managing or operating a running Milvus system, including monitoring, scaling, and maintenance.
+      • "How do I monitor Milvus metrics in Prometheus/Grafana?"
+      • "What’s the best way to scale query nodes horizontally?"
+      • "How can I back up and restore Milvus data?"
+      • "How to perform rolling upgrades without downtime?"
+    `),
+
+    z.literal('data_and_performance').describe(`
+      The user is experiencing missing data, incorrect query results, or performance problems.
+      Examples:
+      • "Inserted data not returned in query results."
+      • "Deleted entities still appear in search results."
+      • "Index building takes 10x longer than expected."
+      • "Queries take several seconds instead of milliseconds."
+    `),
+
+    z.literal('integration_and_solutions').describe(`
+      The user is blocked or has questions while integrating Milvus with external systems, frameworks, or building/operating solutions on top of it.
+      Examples:
+      • "LangChain integration throws connection errors."
+      • "Building a semantic search solution but results are poor."
+      • "Do you support Pinecone migration?"
+      • "How do I design schema for a product search pipeline?"
+    `),
+
+    z.literal('ai_low_confidence_or_docs_missing').describe(`
+      The AI assistant was unable to provide a confident or complete answer due to vague input or lack of documentation.
+      Examples:
+      • "I don't know."
+      • "I can't find relevant information in the documentation."
+      • "You should reach out the community."
+      • "Let's try something else."
+    `),
+
+    z.literal('direct_support_request').describe(`
+      The user is explicitly requesting to contact support or asking for human assistance.
+      Examples:
+      • "Can I talk to support?"
+      • "I need help"
+      • "Is there someone I can speak to?"
+    `),
+  ])
+  .describe("General type of support signal detected in the user's message.");
+
+const detectedSupportSignal = z.object({
+  explanation: z
+    .string()
+    .describe('Short justification for why this is a support-related message.'),
+  type: supportSignalType,
+});
+
 export {
   answerConfidence,
   provideAnswerConfidenceSchema,
   salesSignalType,
   detectedSalesSignal,
+  supportSignalType,
+  detectedSupportSignal,
 };
