Tutorials

Tutorials

Building a Live AI Summarizer Form

A small WinForms project (LiveAISummarizer) puts WithLiveInputFrom to work: type or paste text into one text area, and a summary appears in another a moment after you stop typing, with no button and no Execute() calls of your own.

Complete Program

The full LiveAISummarizer sample project (in the GPAL.sln solution), start to finish. Each part is explained below.

using System;

using System.Drawing;

using GenerallyPositive;

using GenerallyPositive.GPALForm;

using static GenerallyPositive.Enums;

using static GenerallyPositive.GPALForm.GPALForm;

namespace LiveAISummarizer

{

class Program

{

static GPALLabel instructions = GPAL.Label

.WithText("Type or paste text below. The summary updates automatically as you type.")

.WithFont(new Font("Segoe UI", 10.0f))

.ToGPALObject();

static GPALTextArea inputArea = GPAL.TextArea

.WithName("input")

.WithText("")

.WithHeight(220)

.ToGPALObject();

static GPALLabel outputLabel = GPAL.Label

.WithText("Summary:")

.WithFont(new Font("Segoe UI", 10.0f))

.ToGPALObject();

static GPALRichTextBox outputArea = (GPALRichTextBox)GPAL.RichTextBox

.WithName("output")

.WithText("")

.WithHeight(120)

.ToGPALObject();

[STAThread]

static void Main(string[] args)

{

// Wire the AI task to the input text area before the form is shown.

// Every keystroke (after a short debounce) re-runs the summarization

// task against the current input text and writes the result to outputArea.

IGPALAI aiTask = GPAL.AI

.WithProvider("xAI")

.WithTask(AITask.Summarization)

.WithLiveInputFrom(inputArea, debounceMilliseconds: 800)

.WithOutputTo(outputArea)

.ToGPALObject();

GPALForm form = GPAL.Form

.WithTitle("Live AI Summarizer")

.WithLeft(400)

.WithTop(200)

.WithWidth(540)

.WithHeight(480)

.WithFormControl(instructions)

.WithFormControl(inputArea)

.WithFormControl(outputLabel)

.WithFormControl(outputArea)

.ToGPALObject();

form.ShowDialog();

}

}

}

The Form Controls

Two controls do the work: inputArea is a GPALTextArea where text gets typed or pasted, and outputArea is a GPALRichTextBox where the summary appears, rendered from Markdown - headings, **bold** text, and bullet/numbered lists all display formatted instead of as raw symbols. A label above each one gives the user instructions, and WithName gives each control a name that other code (here, the AI wiring) can refer to.

static GPALLabel instructions = GPAL.Label

.WithText("Type or paste text below. The summary updates automatically as you type.")

.WithFont(new Font("Segoe UI", 10.0f))

.ToGPALObject();

static GPALTextArea inputArea = GPAL.TextArea

.WithName("input")

.WithText("")

.WithHeight(220)

.ToGPALObject();

static GPALLabel outputLabel = GPAL.Label

.WithText("Summary:")

.WithFont(new Font("Segoe UI", 10.0f))

.ToGPALObject();

static GPALRichTextBox outputArea = (GPALRichTextBox)GPAL.RichTextBox

.WithName("output")

.WithText("")

.WithHeight(120)

.ToGPALObject();

Wiring the AI Task with WithLiveInputFrom

This is the only piece that's new compared to a plain summarizer: WithLiveInputFrom(inputArea, debounceMilliseconds: 800) takes the place of WithInputFrom. It records inputArea as the source text and registers a debounced TextChanged callback that calls Execute() again on its own. WithOutputTo(outputArea) is unchanged - the summary still gets written back to outputArea.Text. This whole chain runs before the form is built, which matters because the TextChanged callback only gets wired up to the control when the form realizes its controls.

// Configure the AI task and wire it to inputArea BEFORE the form is built/shown.

// debounceMilliseconds: 800 waits for 800ms of no typing before re-running.

IGPALAI aiTask = GPAL.AI

.WithProvider("xAI")

.WithTask(AITask.Summarization)

.WithLiveInputFrom(inputArea, debounceMilliseconds: 800)

.WithOutputTo(outputArea)

.ToGPALObject();

TIP

See Building Live AI Forms with WithLiveInputFrom for why WithLiveInputFrom has to be called before WithFormControl/Show/ShowDialog.

Building and Showing the Form

With the AI task already wired to inputArea, building the form is just GPAL.Form with the four controls added via WithFormControl. Calling form.ShowDialog().ToGPALObject() displays the form and blocks until it's closed. From this point on, typing in inputArea and pausing for 800ms produces a summary in outputArea automatically.

GPALForm form = GPAL.Form

.WithTitle("Live AI Summarizer")

.WithLeft(400)

.WithTop(200)

.WithWidth(540)

.WithHeight(480)

.WithFormControl(instructions)

.WithFormControl(inputArea)

.WithFormControl(outputLabel)

.WithFormControl(outputArea)

.ToGPALObject();

// Nothing needs to run on the form before it's visible, so ShowDialog()

// alone (without a leading .Show()) is enough here. The result of

// ShowDialog() isn't used, so there's no trailing .ToGPALObject().

form.ShowDialog();

On this page

Tutorials
Building a Live AI Summarizer Form
  • Complete Program
  • The Form Controls
  • Wiring the AI Task with WithLiveInputFrom
  • Building and Showing the Form