🧩 Overview

The Groq Connector enables OutSystems applications to seamlessly integrate with Groq’s ultra-fast AI inference platform through a unified API.
By connecting with Groq, developers can quickly enable advanced AI-powered features such as real-time summarization, natural language Q&A, and intelligent chatbots, without dealing with complex REST setups or performance bottlenecks.

The connector abstracts API complexity and allows interaction with Groq-hosted AI models through structured message formats, providing lightning-fast inference and low-latency responses.

📦 Installation

1. Download the Groq Connector from the OutSystems Forge.
   
   

2. Add it as a dependency in your application:
   
   

   • Open Service Studio → Manage Dependencies
     
     

   • Search for Groq Connector and include it in your module.
     
     

Once added, you can access all the available Server Actions, Structures provided by the connector.

✅ Prerequisites

• Groq Account:
  Sign up or access your account via groq.com or through your organization’s integration setup.
  
  

• Groq API Key:
  Generate or retrieve your API key from your Groq developer console or your organization’s administrator.
  This key is required for authenticating API requests securely.
  
  

🚀 Usage Instructions

1️⃣ Use the Server Action

In your OutSystems logic flow, drag and use the Groq Connector Server Action wherever you need to send a request to Groq’s AI platform.

2️⃣ Provide Required Parameters

🧾 Example messages JSON

[

  { "role": "system", "content": "You are a helpful assistant that provides clear and accurate answers to user questions." },

  { "role": "user", "content": "Who was the first Prime Minister of India?" }

]

Common roles:

• system → Defines how the AI should behave.
  
  

• user → Represents user input.
  
  

• assistant → Represents the AI’s generated response.
  
  

3️⃣ Handle the Result Response

The Server Action returns a structured Result Response that contains Groq’s AI-generated reply.
You can then display this response in your application’s UI as a message, summary, or dynamic answer.

💡 Demo Reference: Paragraph Summarizer

The GroqConnector_Demo module demonstrates a real-world use case — summarizing long paragraphs into concise summaries using Groq’s AI.
This demo highlights Groq’s low latency and high-speed inference capabilities in an OutSystems application.

🔁 How the Demo Works

• API Key Configuration: Store your Groq API key securely in your app’s Site Properties.
  
  

• Message Roles:
  
  

  • system: “You are a helpful assistant that summarizes long text into a short and clear paragraph.”
    
    

  • user: Contains the paragraph entered by the user.
    
    

📌 Summarization Flow

1. The user enters a long paragraph.
   
   

2. On clicking Summarize, the connector sends messages to Groq’s model.
   
   

3. Groq processes and returns the summarized output.
   
   

4. The summary is displayed instantly in the app UI.
   
   

🖼️ UI Layout

• Text to Summarize: Input field for long text.
  
  

• Summarize Button: Sends the request to Groq.
  
  

• Summary Field: Displays the AI-generated summary result.
  
  

⚙️ How to Implement the Demo in Your App

1️⃣ Install the Demo Module

Download and publish GroqConnector_Demo from Forge.

2️⃣ Configure Site Properties

Set your API key in the GroqApiKey site property.

3️⃣ Logic Flow Example

[

  { "role": "system", "content": "You are a helpful assistant that summarizes long text into a short and clear paragraph." },

  { "role": "user", "content": <user input paragraph> }

]

Call the Server Action:

response = GroqConnector.ServerAction(

  api_key = GetSiteProperty("Groq_ApiKey"),

  model_id = "llama3-70b",

  messages = messages

)

SummarizedResultField.Text = response.result

✅ Best Practices

• 🔐 API Key Security: Store API keys in Site Properties or environment variables. Never hard-code them in client logic.
  
  

• 🧠 Structured Prompts: Define clear role-based prompts for consistent AI responses.
  
  

• ⚙️ Error Handling: Gracefully handle API timeouts or failures with fallback messages.
  
  

• 🪶 Model Selection: Choose the model that best fits your task — e.g., llama3-70b for conversational AI or mixtral-8x7b for summarization.
  
  

🛠️ Troubleshooting

🚀 Summary

The Groq Connector is the fastest and most efficient way to bring AI intelligence into your OutSystems applications.
With minimal setup and lightning-fast responses, it allows developers to embed summarization, chat, and AI-driven insights — all powered by Groq’s high-performance inference engine ⚡.