AIDocProcessingService.AskAIAsync(Presentation, String, RagOptions, CancellationToken) Method

Returns a response to a custom question about the presentation content.

Namespace: DevExpress.AIIntegration.Docs

Assembly: DevExpress.AIIntegration.Docs.v25.2.dll

NuGet Package: DevExpress.AIIntegration.Docs

Declaration

C#

public Task<string> AskAIAsync(
    Presentation presentation,
    string question,
    RagOptions options,
    CancellationToken cancellationToken = default(CancellationToken)
)

VB.NET

Public Function AskAIAsync(
    presentation As Presentation,
    question As String,
    options As RagOptions,
    cancellationToken As CancellationToken = Nothing
) As Task(Of String)

Parameters

Name	Type	Description
presentation	Presentation	The Presentation instance that contains the content to be questioned.
question	String	The question about the presentation content.
options	RagOptions	An object that contains retrieval-augmented generation (RAG) options.

Optional Parameters

Name	Type	Default	Description
cancellationToken	CancellationToken	null	The token that cancels the task.

Returns

Type	Description
Task<String>	The response that contains an AI-generated answer.

Example

Example: Ask a Question about Presentation Content

The following code snippet asks a question about the document content, configures RAG options (chunk size, collection name, chunk count), and inserts the AI‑generated answer as content in the first slide:

C#

using DevExpress.AIIntegration;
using DevExpress.AIIntegration.Docs;
using DevExpress.Docs.Presentation;
using Microsoft.Extensions.AI;

// Create a document processing service instance
// from the AI extensions container.
var docProcessingService = new AIDocProcessingService(defaultAIExtensionsContainer);

var options = new RagOptions
{
    VectorCollectionName = "document_embeddings",
    ChunkSize = 800,
    AugmentationChunkCount = 8
};

var presentation = new Presentation(File.ReadAllBytes("Documents/Presentation.pptx"));
string summary = await docProcessingService.AskAIAsync(
    presentation,
    "Does this document contain any confidential information?",
    options);
Slide slide = new Slide(new SlideLayout(layoutType: SlideLayoutType.Blank, name: "slide"));
AddTextToSlide(slide, summary);

presentation.Slides.Insert(0, slide);

string targetDir = @"C:\Test Documents";
Directory.CreateDirectory(targetDir);
string outputPath = Path.Combine(targetDir, "presentation.pptx");

using (FileStream outputStream = new FileStream(outputPath, FileMode.Create, FileAccess.Write))
{
    presentation.SaveDocument(outputStream, DocumentFormat.Pptx);
}

void AddTextToSlide(Slide slide, string text)
{
    Shape shape = new Shape(ShapeType.Rectangle);
    shape.X = 0; shape.Y = 0;
    shape.Width = presentation.SlideSize.Width;
    shape.Height = presentation.SlideSize.Height;
    shape.TextArea = new TextArea
    {
        Text = $"Summary by DevExpress AI Extensions:\r\n{text}",
        ParagraphProperties = new ParagraphProperties
        {
            TextProperties = new TextProperties
            {
                Fill = new SolidFill(Color.FromArgb(168, 177, 184)),
                FontSize = 24
            }
        },
        Properties = new TextAreaProperties
        {
            AutoFit = TextAutoSize.Shape
        }
    };
    shape.Fill = new SolidFill(Color.FromArgb(21, 25, 28));
    shape.Outline = new LineStyle { Fill = new SolidFill(Color.FromArgb(21, 25, 28)) };

    slide.Shapes.Add(shape);
}

VB.NET

Imports DevExpress.AIIntegration
Imports DevExpress.AIIntegration.Docs
Imports DevExpress.Docs.Presentation
Imports Microsoft.Extensions.AI
Imports System.IO
Imports System.Drawing

' Create a document processing service instance
' from the AI extensions container.
Dim docProcessingService As New AIDocProcessingService(defaultAIExtensionsContainer)

Dim options As New RagOptions With {
    .VectorCollectionName = "document_embeddings",
    .ChunkSize = 800,
    .AugmentationChunkCount = 8
}

Dim presentation As New Presentation(File.ReadAllBytes("Documents/Presentation.pptx"))
Dim summary As String = Await docProcessingService.AskAIAsync(
    presentation,
    "Does this document contain any confidential information?",
    options)

Dim slide As New Slide(New SlideLayout(layoutType:=SlideLayoutType.Blank, name:="slide"))
AddTextToSlide(slide, summary)

presentation.Slides.Insert(0, slide)

Dim targetDir As String = "C:\Test Documents"
Directory.CreateDirectory(targetDir)
Dim outputPath As String = Path.Combine(targetDir, "presentation.pptx")

Using outputStream As New FileStream(outputPath, FileMode.Create, FileAccess.Write)
    presentation.SaveDocument(outputStream, DocumentFormat.Pptx)
End Using

Private Sub AddTextToSlide(slide As Slide, text As String)
    Dim shape As New Shape(ShapeType.Rectangle) With {
        .X = 0,
        .Y = 0,
        .Width = presentation.SlideSize.Width,
        .Height = presentation.SlideSize.Height,
        .TextArea = New TextArea With {
            .Text = $"Summary by DevExpress AI Extensions:{vbCrLf}{text}",
            .ParagraphProperties = New ParagraphProperties With {
                .TextProperties = New TextProperties With {
                    .Fill = New SolidFill(Color.FromArgb(168, 177, 184)),
                    .FontSize = 24
                }
            },
            .Properties = New TextAreaProperties With {
                .AutoFit = TextAutoSize.Shape
            }
        },
        .Fill = New SolidFill(Color.FromArgb(21, 25, 28)),
        .Outline = New LineStyle With {
            .Fill = New SolidFill(Color.FromArgb(21, 25, 28))
        }
    }

    slide.Shapes.Add(shape)
End Sub

Implements

AskAIAsync(Presentation, String, RagOptions, CancellationToken)