IA+ Platform Documentation

Learn how to integrate AI-powered features into your legacy web applications with the IA+ Platform.

Note: This is a POC (Proof of Concept). The platform is designed to demonstrate how AI features can be added to existing web applications with minimal code changes.

Installation

Step 1: Create an Integration Instance

First, create an integration instance in the IA+ Platform dashboard:

  1. Navigate to Create Instance
  2. Fill in your application details
  3. Configure allowed domains
  4. Select your preferred LLM provider (Ollama, OpenAI, Anthropic)
  5. Copy your generated API token (shown only once!)

Step 2: Add the SDK to Your HTML

Add the IA+ SDK script to your HTML page. The SDK will automatically detect and empower configured input fields.

Basic Integration (Same Domain)

When your application and the IA+ Platform are on the same domain: 

<script src="/api/cdn/iaplus.js?token=YOUR_TOKEN_HERE"></script>

Cross-Domain Integration (CDN/WAF)

When the SDK is served from a different domain (e.g., behind a WAF or CDN), specify the API backend URL: 

<script src="https://cdn.example.com/api/cdn/iaplus.js?token=YOUR_TOKEN&apiUrl=https://api.iaplus.com"></script>

SDK Parameters

  • token (required) - Your instance API token
  • apiUrl (optional) - Custom API backend URL for cross-domain deployments

Security: Make sure to add your domain to the allowed domains list in your instance configuration. Requests from unauthorized domains will be rejected.

Configuration

Input Configuration (Edit Mode)

Enable AI actions on specific input fields using the SDK's Edit Mode:

  1. Navigate to the page where you want to enable AI features
  2. Click the Edit toggle in the bottom bar
  3. Click on any input or textarea to enable/disable AI actions
  4. Green outline = AI enabled, Blue outline = available for configuration

URL Pattern Configuration

Configure which pages should use the input configurations:

  • /contact - Exact path match
  • /api/mock/* - Wildcard match (all pages under /api/mock/)
  • /users/:id - Dynamic segment match

Note: Each page can have its own URL pattern. Patterns are stored per-page in localStorage to avoid conflicts between different pages.

Domain Allowlisting

The platform supports flexible domain patterns:

  • example.com - Exact domain match
  • *.example.com - All subdomains
  • * - Allow all domains (not recommended for production)

LLM Provider Selection

Choose from three LLM providers:

🦙 Ollama

Local, open-source models. Best for privacy and cost control.

🤖 OpenAI

GPT-4, GPT-3.5. Industry-leading performance.

🧠 Anthropic

Claude models. Great for complex reasoning.

Actions

Default Actions

The platform comes with 10 pre-built actions:

Translate to French

Translates input text to French

Translate to English

Translates input text to English

Reformulate (Professional)

Rewrites text in a professional tone

Reformulate (Friendly)

Rewrites text in a friendly, casual tone

Summarize

Creates a concise summary of the text

Make Shorter

Makes text shorter while keeping the main points

Make Longer

Expands text with more details and explanation

Simplify

Simplifies text to make it easier to understand

Improve Writing

Makes text more professional and clear

Fix Grammar

Corrects grammar and spelling mistakes

Custom Actions

Create your own AI actions with custom prompts:

  1. Navigate to Create Action
  2. Define a unique action ID (e.g., fix_grammar)
  3. Write your prompt template using {inputValue} placeholder
  4. Configure LLM settings (temperature, max tokens)
Example prompt template:
Fix all grammar and spelling errors in the following text.
Return only the corrected text:

{inputValue}

API Reference

SDK Methods

IAPlus.init(config)

Initialize the SDK with configuration options

IAPlus.enableInput(selector, actions)

Enable AI actions on specific input elements

IAPlus.executeAction(actionId, text)

Programmatically execute an action

Examples

Basic Contact Form

<form>
  <label>Your Message</label>
  <textarea id="contact-message"
            class="ia-enabled"
            data-actions="translate_french,reformulate_professional">
  </textarea>

  <button type="submit">Send</button>
</form>

Support Ticket Form

<form>
  <label>Describe your issue</label>
  <textarea id="issue-description"
            class="ia-enabled"
            data-actions="translate_english,summarize">
  </textarea>

  <button type="submit">Submit Ticket</button>
</form>

Need help? Visit the Dashboard or create a new Integration Instance.