AI Tools

AI tools are available once AI is turned on, with your own engine or Stirling Cloud AI.

Capabilities#

Capability	Where to use it	Setting under `aiEngine.features`
Chat and document questions	Open the assistant in the workbench to ask about attached PDFs or request edits.	`chat`, `documentQuestions`
Maths auditing	Ask the assistant to check calculations and figures.	`mathAuditor`
Review comments	Ask the assistant to add comments to a PDF.	`pdfComment`
Document creation	Ask the assistant to create a PDF from a description.	`createPdf`
Classification	Label uploaded documents or use the Processor's Classification template.	`classify`

Document creation requires WeasyPrint on the Stirling PDF server. If it is installed somewhere other than /opt/venv/bin/weasyprint, set its location:

yaml

system:
  customPaths:
    operations:
      weasyprint: /usr/local/bin/weasyprint

bash

SYSTEM_CUSTOMPATHS_OPERATIONS_WEASYPRINT=/usr/local/bin/weasyprint

yaml

services:
  stirling-pdf:
    environment:
      SYSTEM_CUSTOMPATHS_OPERATIONS_WEASYPRINT: /usr/local/bin/weasyprint

Disable a capability#

All feature switches default to true. Turn one off under Capabilities in Settings → Server → AI Engine, or set it to false and restart Stirling PDF. For example, to turn off document creation:

yaml

aiEngine:
  features:
    createPdf: false

bash

AIENGINE_FEATURES_CREATEPDF=false

yaml

services:
  stirling-pdf:
    environment:
      AIENGINE_FEATURES_CREATEPDF: "false"

To disable conversation entirely, set both chat and documentQuestions to false.

Server-side classification pipelines require classify to remain enabled. Use property-based routing for workflows without AI classification.

See AI Settings Reference for the complete settings list and MCP Server to control AI tools exposed over MCP.

Edit this page on GitHub