[AI-3] PLU-583: (backend) mutation to generate AI steps

[kevinkim-ogp]

TL;DR

Adds a new GraphQL mutation generateAiSteps that allows users to create workflow steps using natural language descriptions.

• Zod schemas for validating input, triggers, and actions
• Integration with Langfuse (https://rome.pair.gov.sg) for prompt management and telemetry

The mutation accepts a trigger description and action descriptions in natural language, then returns structured workflow steps that can be used in the workflow builder.

How to test?

• Call the generateAiSteps mutation and receive an object with the trigger and actions

Example

Input

mutation generateAiSteps($input: GenerateAiStepsInput!) {
  generateAiSteps(input: $input)
}

{
  "input": {
    "trigger": "When a new event attendance is received",
    "actions": "Find the attendee in Tiles\nIf the attendee is found, update the Attended? column to Yes\nIf the attendee is not found, create a new row in Tiles with the attendee's details."
  }
}

Output

{
  "data": {
    "generateAiSteps": {
      "trigger": {
        "position": 1,
        "type": "trigger",
        "appKey": "formsg",
        "key": "newSubmission",
        "description": "Triggers when a new event attendance form submission is received"
      },
      "actions": [
        {
          "description": "Find the attendee in Tiles database",
          "type": "action",
          "config": {
            "stepName": "Find Attendee",
            "templateConfig": {}
          },
          "position": 2,
          "appKey": "tiles",
          "key": "findSingleRow"
        },
        {
          "description": "Check if attendee was found in the database",
          "type": "action",
          "config": {
            "stepName": "If Attendee Found",
            "templateConfig": {}
          },
          "position": 3,
          "appKey": "toolbox",
          "key": "ifThen",
          "parameters": {
            "depth": 0,
            "branchName": "Attendee Found"
          }
        },
        {
          "description": "Update the Attended? column to Yes for existing attendee",
          "type": "action",
          "config": {
            "stepName": "Update Attendance Status",
            "templateConfig": {}
          },
          "position": 4,
          "appKey": "tiles",
          "key": "updateSingleRow"
        },
        {
          "description": "Check if attendee was not found in the database",
          "type": "action",
          "config": {
            "stepName": "If Attendee Not Found",
            "templateConfig": {}
          },
          "position": 5,
          "appKey": "toolbox",
          "key": "ifThen",
          "parameters": {
            "depth": 0,
            "branchName": "Attendee Not Found"
          }
        },
        {
          "description": "Create a new row in Tiles with the attendee's details and mark as attended",
          "type": "action",
          "config": {
            "stepName": "Create New Attendee Record",
            "templateConfig": {}
          },
          "position": 6,
          "appKey": "tiles",
          "key": "createTileRow"
        }
      ]
    }
  }
}

[kevinkim-ogp]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• [AI-11] PLU-605: chat feedback #1352
• refactor: AI form modal #1311
• [AI-10] PLU-604: Preview steps and create Pipe #1310
• [AI-9] PLU-603: Chat interface #1309
• [AI-8] PLU-584: add api for chat streaming #1307
• [AI-7]: setup api route for chat streaming #1306
• [AI-6]: add ai related deps for frontend #1305
• [AI-5]: create pipe from generated steps #1304
• [AI-4] PLU-595: frontend to enter prompt and generate steps #1303
• [AI-3] PLU-583: (backend) mutation to generate AI steps #1302 👈 (View in Graphite)
• [AI-2]: Bump typescript and eslint deps #1301 : 1 other dependent PR (#1312 )
• [AI-1]: Install deps and bump zod #1300
• trunk/ai

This stack of pull requests is managed by Graphite. Learn more about stacking.

[linear]

PLU-583 AI: Onboard to langfuse