๐Ÿ”ŒEnable AI

This guide explains how to enable and configure AI functionality in PIARA Lite using the OpenAI API. Once connected, PIARA can use AI models to analyze and enrich both text and image data in your instance.

โ„น๏ธ PIARA Premium also supports Google Gemini and Ollama, using the same configuration flow.


๐Ÿค– What Is an AI Model in PIARA?

In PIARA, an AI Model is a combination of:

  • A provider (e.g., OpenAI, Google, Ollama)

  • A billing account (via API key)

  • A specific model from that provider (e.g., gpt-4.1, gpt-4.1-nano)

This modular design provides flexibility and encourages experimentation with AI.

๐Ÿ› ๏ธ AI Models are system-wide configurations available to all users in the instance.

๐Ÿ’ก Notes

  • PIARA Lite supports OpenAI models only.

  • PIARA Premium adds support for Google Gemini and Ollama.


๐Ÿ“‹ Prerequisites

Make sure the following requirements are met before you proceed:

  • โœ… A fully deployed instance of PIARA Lite

  • ๐Ÿ”‘ A valid OpenAI API key

  • ๐Ÿงช (Optional) Some data already present in PIARA

  • ๐Ÿ“„ Required configuration parameters (listed below)


โš™๏ธ Required Configuration Parameters

Parameter
Value / Source

URL

https://api.openai.com


๐Ÿ› ๏ธ Setup Instructions

1. Open the AI Model Management Page

Navigate to: System > AI Models Management

๐Ÿ“‚ If no models are configured, the list will be empty.

2. Add a New AI Model

Click โ€œAdd Modelโ€ and fill in the fields:

Title

A unique name for the model (e.g., GPT-4.1-nano)

Description

(Optional) Notes for internal use

URL

https://api.openai.com

API Key

Your key from OpenAI API Keys

Model Type

e.g., gpt-4.1-nano, gpt-4.1, etc. (See model list)

Connector

Select OpenAI (PIARA Lite only supports OpenAI)

Inputs

Select Text, Image, or both (depends on model capabilities)

Options

(Optional) JSON config for advanced use (not covered in this guide)

3. Test the Connection

After saving the model:

  1. Click โ€œSave and Testโ€

  2. Enter a sample input (e.g., Hello AI!)

  3. Click Submit

  4. โœ… Confirm successful connection

4. (Optional) Add More Models

You can configure multiple models to support various use cases:

  • Use unique names for each model

  • Select different model types (e.g., lightweight vs full-scale)


โœ… Result

Once set up, your models will appear in the list and can be used in enrichment and automation features throughout PIARA.

Last updated