✨AI Column: [Part 1] New properties (aiIntegration, prompt, mode) (DevExpress#31219)

Author: Raushen

packages/devextreme/js/__internal/core/ai_integration/commands/generateGridColumn.ts

@@ -0,0 +1,32 @@
+import type { GenerateGridColumnCommandParams, GenerateGridColumnCommandResult } from '@js/common/ai-integration';
+import { BaseCommand } from '@ts/core/ai_integration/commands/base';
+import type { PromptData, PromptTemplateName } from '@ts/core/ai_integration/core/prompt_manager';
+
+export class GenerateGridColumnCommand extends BaseCommand<
+  GenerateGridColumnCommandParams,
+  GenerateGridColumnCommandResult
+> {
+  protected getTemplateName(): PromptTemplateName {
+    return 'generateColumn';
+  }
+
+  protected buildPromptData(params: GenerateGridColumnCommandParams): PromptData {
+    const dataDescription = this.generateDataDescription(params.data);
+    return {
+      user: {
+        text: params.text,
+        data: dataDescription,
+      },
+    };
+  }
+
+  protected parseResult(response: string): GenerateGridColumnCommandResult {
+    const result: GenerateGridColumnCommandResult = JSON.parse(response);
+    return result;
+  }
+
+  private generateDataDescription(data: Record<PropertyKey, unknown>): string {
+    const result = JSON.stringify(data);
+    return result;
+  }
+}

packages/devextreme/js/__internal/core/ai_integration/core/ai_integration.ts

@@ -9,6 +9,8 @@ import type {
   ExecuteCommandResult,
   ExpandCommandParams,
   ExpandCommandResult,
+  GenerateGridColumnCommandParams,
+  GenerateGridColumnCommandResult,
   ProofreadCommandParams,
   ProofreadCommandResult,
   RequestCallbacks,
@@ -36,6 +38,8 @@ import {
 import { PromptManager } from '@ts/core/ai_integration/core/prompt_manager';
 import { RequestManager } from '@ts/core/ai_integration/core/request_manager';
 
+import { GenerateGridColumnCommand } from '../commands/generateGridColumn';
+
 export const enum CommandNames {
   ChangeStyle = 'changeStyle',
   ChangeTone = 'changeTone',
@@ -46,6 +50,7 @@ export const enum CommandNames {
   Summarize = 'summarize',
   Translate = 'translate',
   SmartPaste = 'smartPaste',
+  GenerateGridColumn = 'generateGridColumn',
 }
 
 export const COMMANDS = {
@@ -58,6 +63,7 @@ export const COMMANDS = {
   [CommandNames.Summarize]: SummarizeCommand,
   [CommandNames.Translate]: TranslateCommand,
   [CommandNames.SmartPaste]: SmartPasteCommand,
+  [CommandNames.GenerateGridColumn]: GenerateGridColumnCommand,
 } as const;
 
 export interface CommandDefinition<TParams, TResult> {
@@ -76,6 +82,10 @@ export interface Commands {
   [CommandNames.Summarize]: CommandDefinition<SummarizeCommandParams, SummarizeCommandResult>;
   [CommandNames.Translate]: CommandDefinition<TranslateCommandParams, TranslateCommandResult>;
   [CommandNames.SmartPaste]: CommandDefinition<SmartPasteCommandParams, SmartPasteCommandResult>;
+  [CommandNames.GenerateGridColumn]: CommandDefinition<
+    GenerateGridColumnCommandParams,
+    GenerateGridColumnCommandResult
+  >;
 }
 
 export class AIIntegration implements IAIIntegration {
@@ -210,4 +220,15 @@ export class AIIntegration implements IAIIntegration {
       callbacks,
     );
   }
+
+  public generateGridColumn(
+    params: GenerateGridColumnCommandParams,
+    callbacks: RequestCallbacks<GenerateGridColumnCommandResult>,
+  ): () => void {
+    return this.executeCommand(
+      CommandNames.GenerateGridColumn,
+      params,
+      callbacks,
+    );
+  }
 }

packages/devextreme/js/__internal/core/ai_integration/core/prompt_manager.ts

@@ -20,7 +20,8 @@ export type PromptTemplateName =
   | 'shorten'
   | 'summarize'
   | 'translate'
-  | 'smartPaste';
+  | 'smartPaste'
+  | 'generateColumn';
 
 export type PromptTemplates = Map<PromptTemplateName, PromptTemplate>;
 

packages/devextreme/js/__internal/core/ai_integration/templates/index.ts

@@ -31,4 +31,8 @@ export const templates: PromptTemplates = {
     system: 'You are a helpful assistant that helps to fill fields based on the text provided. You will get a text and a list of fields that should be filled using info from the text. It can include the name of field, suitable format, optionally some additional instruction about what it should include. You need to return data for all the fields in the following format without any preamble, introduction, or explanatory text: {fieldName}:::{fieldValue};;;{fieldName}:::{fieldValue} and so on, where {fieldName} - is a variable for a field name and {fieldValue} - is a variable for a string to fill. If there is no info to fill, field value should be empty (like Name:::;;;)- do not use placeholders like (empty), N/A, null, or similar. Only fill in date fields if a complete date is explicitly present. If the date is missing or incomplete, leave the field empty.',
     user: 'Text: {{text}}. Fields: {{fields}}.',
   },
+  generateColumn: {
+    system: 'You are a helpful assistant that generates column data based on the provided text and existing data context. Generate appropriate column values that match the request and are consistent with the existing data structure.',
+    user: 'Text: {{text}}. Data: {{data}}.',
+  },
 };