File Attachments

Kirby Copilot lets you select files to enrich the user prompt with additional information. For example, you can select product images and ask the AI model to describe the product visually or select PDF files and let the AI model use these documents to generate summaries or extract key information.

Supported AI Models

In order to pass images or PDF files as input, you need an AI model that supports file processing. Currently, the following models support image and PDF input:

• OpenAI's ChatGPT and other reasoning models
• Anthropic's Claude models
• Google's Gemini models
• Mistral AI's Mistral models

Images

Resizing

Selected images are downscaled in the browser to fit within 2048 pixels before they are sent to the AI provider.

Processing PDF Files

PDF files can be used to support user prompts with information that the AI model can incorporate to generate answers. For example, you can select a PDF with a product description and ask the AI model to summarize the product in a few sentences.

When selecting PDF files with the Select files button, the plugin sends them directly to the AI provider along with your prompt. The AI model reads the document's structure, formatting, and content natively.

File as Context Source

On a Kirby file page, a Copilot section with files: auto attaches the current image as context – for alternative text, captions, or descriptions. Only images are attached this way; attach a PDF through the file picker instead, which files: true provides.