$npx -y skills add DevExpress/agent-skills --skill devexpress-office-file-api-ai-powered-extensionsBuild .NET applications with the DevExpress AI-Powered Extensions for Office File API to add NLP-powered document processing capabilities — proofreading, translation, and text transformation for Word documents, PDF files, and PowerPoint presentations. Use when integrating AI lang
| 1 | # DevExpress AI-Powered Extensions for Office File API |
| 2 | |
| 3 | The DevExpress AI-Powered Extensions integrate language models into the Office File API through the `Microsoft.Extensions.AI` (`IChatClient`) abstraction. Extensions support proofreading, translation, summarization, and contextual Q&A (Ask AI) for Word Processing documents, PDF files, and PowerPoint presentations. Both cloud providers (Azure OpenAI, OpenAI, Google Gemini) and local models (Ollama, ONNX Runtime, AI Foundry Local) are supported. The API follows a BYOK ("bring your own key") model — no DevExpress-hosted LLM is included. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Use this skill when you need to: |
| 8 | |
| 9 | - Proofread a Word document (.docx) or PowerPoint presentation with AI (grammar, spelling, style) |
| 10 | - Translate a Word document, PDF file, or PowerPoint presentation to another language |
| 11 | - Translate a specific paragraph, range, slide, or page region rather than the whole document |
| 12 | - Summarize the content of a Word document, PDF file, or presentation |
| 13 | - Ask contextual questions about document content using RAG (Retrieval-Augmented Generation) |
| 14 | - Register an AI provider (Azure OpenAI, OpenAI, Ollama, Gemini, ONNX, AI Foundry Local) with the DevExpress container |
| 15 | - Use the `AIDocProcessingService` or `IAIDocProcessingService` in a console app or ASP.NET Core / Blazor application |
| 16 | - Preserve formatting while performing AI-powered document transformations |
| 17 | - Process documents in a headless / server-side .NET environment without a UI control |
| 18 | |
| 19 | ## Prerequisites & Installation |
| 20 | |
| 21 | ### NuGet Packages |
| 22 | |
| 23 | | Package | Purpose | |
| 24 | |---------|---------| |
| 25 | | `DevExpress.AIIntegration` | Core AI container and `IChatClient` wiring | |
| 26 | | `DevExpress.AIIntegration.Docs` | Office File API AI extensions (`AIDocProcessingService`) | |
| 27 | | `DevExpress.Document.Processor` | Word Processing and Spreadsheet document engines | |
| 28 | | `DevExpress.Docs.Presentation` | Presentation (PPTX) document engine | |
| 29 | |
| 30 | Plus **one** AI provider package group (choose one): |
| 31 | |
| 32 | | Provider | Required Packages | |
| 33 | |----------|------------------| |
| 34 | | Azure OpenAI | `Azure.AI.OpenAI` (2.2.0-beta.5), `Microsoft.Extensions.AI.OpenAI` (9.7.1-preview) | |
| 35 | | OpenAI | `OpenAI` (2.2.0), `Microsoft.Extensions.AI.OpenAI` (9.7.1-preview) | |
| 36 | | Ollama (self-hosted) | `OllamaSharp` | |
| 37 | | Google Gemini / Claude (Semantic Kernel) | `Microsoft.SemanticKernel`, `Microsoft.SemanticKernel.Connectors.*` | |
| 38 | | AI Foundry Local | `Microsoft.AI.Foundry.Local` (0.8.2.1+), `Microsoft.Extensions.AI.OpenAI` | |
| 39 | | ONNX Runtime | `Microsoft.ML.OnnxRuntimeGenAI` | |
| 40 | |
| 41 | ### .NET CLI (Azure OpenAI example) |
| 42 | |
| 43 | ```bash |
| 44 | dotnet add package DevExpress.AIIntegration |
| 45 | dotnet add package DevExpress.AIIntegration.Docs |
| 46 | dotnet add package DevExpress.Document.Processor |
| 47 | dotnet add package DevExpress.Docs.Presentation |
| 48 | dotnet add package Azure.AI.OpenAI --version 2.2.0-beta.5 |
| 49 | dotnet add package Microsoft.Extensions.AI.OpenAI --version 9.7.1-preview.1.25365.4 |
| 50 | ``` |
| 51 | |
| 52 | **Important**: All DevExpress packages must share the same version. A valid DevExpress Universal or Office File API Subscription is required. Supported runtimes: .NET 8+ or .NET Framework 4.7.2. |
| 53 | |
| 54 | ### Package Versions |
| 55 | |
| 56 | Unless the user explicitly requests a specific version, always target the latest DevExpress release (v26.1 at the time of writing). `dotnet add package <PackageName>` without `--version` installs the latest stable version for `DevExpress.*` packages — prefer this form. Never pin an older DevExpress version in project files, Dockerfiles, or CI/CD pipelines unless the user asks for it. This does not apply to the third-party AI provider packages above (`Azure.AI.OpenAI`, `Microsoft.Extensions.AI.OpenAI`, etc.) — their pinned preview/beta versions are intentional and should be kept unless the user requests otherwise. |
| 57 | |
| 58 | ## Before You Start — Ask the Developer |
| 59 | |
| 60 | If the host agent has a structured question-asking tool available, use it to ask these questions one at a time with clear options — for example, Claude Code's `AskUserQuestion` tool or GitHub Copilot's `askQuestions` tool. If no such tool is available, ask the questions directly in the chat response before gene |