What's new ⬇ Download Reportworq
⬇ Guide PDF

Connect an AI provider#

Reportworq's AI features do not embed a fixed model. Instead, an administrator configures one or more AI provider connections, each of which names a provider, holds its credentials and model selection, and carries an Enabled flag. Every AI feature, such as insights and the RWAIINSIGHT function, then resolves a model from the set of enabled connections. Configuring at least one enabled connection is the single prerequisite for all AI in the product.

When to use it. Do this once, during setup, before authors add AI narrative to their distribution jobs or use the RWAIINSIGHT function. With no enabled connection, the AI features stay hidden or cannot run.

Before you start#

Add and enable a connection#

  1. Go to Settings ▸ Integrations and choose Add integration.
  2. In the AI Connections group, pick the provider tile. A new connection is created disabled, with provider defaults, and its editor opens.
  3. At the top of the editor, set the common integration chrome: a Display name (this is how authors pick the connection later, and how the RWAIINSIGHT function resolves it, so make it recognizable), and Availability, the workspaces this connection is visible in.
  4. Fill in the provider's required fields (see the table below).
  5. Choose Test connection. Reportworq calls the provider and reports success or the provider's own error message.
  6. Turn on the Enable Integration checkbox at the top of the editor, then Save. Only enabled connections are used by downstream features. Save stays disabled until you have changed something.

Provider reference#

Provider Required fields Notable options and defaults
OpenAI API Key, Model Id Optional Organization Id. Default Temperature 0.7, Default Max Tokens 1024. Model Id defaults to gpt-5.1. Temperature range 0-2.
Azure OpenAI Endpoint, Deployment Name, API Key Default Temperature 0.7, Default Max Tokens 1024. Temperature range 0-2. Create the Azure OpenAI resource and deploy a model first, then record the Deployment Name, API Key, and Endpoint.
Amazon Bedrock Access Key Id, Secret Access Key, Region, Model Family, Model Id Optional Session Token. Default Temperature 0.5, Default Max Tokens 1024. Temperature range 0-1. The Model Family dropdown currently offers Anthropic only. Region is the source region for request origination. Supply a Session Token only if your organization's security policy requires one.
Google Gemini Connect with (Gemini API key or Vertex AI service account), then API Key, or Service Account Key, Project Id and Location. Model Model list loads from Google once credentials are entered. Default Temperature 1.0, Default Max Tokens 2048, Thinking Level low, Thinking Token Allowance 8192. See Connect Google Gemini.
Reportworq AI Model Tier No API key, access is brokered through your license with managed token quotas. Shows a Token Usage and Quota panel with a Check now action. Available only when your license grants the hosted-AI entitlement.

Connect Google Gemini#

A Google Gemini connection can reach Gemini in two ways. Pick the one that matches how your organization buys Google AI, using Connect with at the top of the editor.

Gemini API (API key)#

  1. Open Google AI Studio and sign in.
  2. Choose Create API key, pick a Google Cloud project (or let AI Studio create one), and copy the key.
  3. In Reportworq, set Connect with to Gemini API (API key) and paste the key into API Key.

Vertex AI (service account)#

  1. In the Google Cloud console, select your project and enable the Vertex AI API (APIs and Services, Library).
  2. Create a service account (IAM and Admin, Service Accounts) and grant it the Vertex AI User role (roles/aiplatform.user) on that project.
  3. Open the service account, choose Keys, Add key, Create new key, pick JSON, and download the file.
  4. In Reportworq, set Connect with to Vertex AI (service account). Paste the whole contents of the JSON file into Service Account Key, enter the Project Id (the id, not the display name), and keep Location as global unless your organization requires a region such as us-central1 or europe-west4.

Once saved, the key is not shown again. The editor shows the service account's email instead, with a Replace button.

Choose a model#

After you enter credentials, the Model list fills from Google with the text models those credentials can use. It reloads a moment after you change a credential, and Refresh reloads it on demand (the list is otherwise cached for 15 minutes). If the list cannot load, the editor says why, for example that the key was refused or the location was not found. You can always choose Type a model id and enter an id such as gemini-2.5-flash yourself. A saved model that is no longer in the list stays selected, with a warning, so it is never cleared for you. On Vertex AI the list is Google's catalog for the location, so a listed model can still be refused by your project when it runs.

Thinking#

Gemini models think before they answer, and the thinking uses the same output limit as the answer. Default Max Tokens is the size of the visible answer; Reportworq adds the Thinking Token Allowance on top so that thinking cannot use up the answer. Thinking Level (none, low, medium, high) sets how much the model thinks; none sends no thinking setting. Keep Default Temperature at 1.0 unless you have a reason to change it: Google advises that lower values can make newer Gemini models repeat themselves.

Credentials stay with the connection#

A Gemini connection uses only the key or service account saved in its editor. Google environment variables or a gcloud login on the Reportworq server (such as GOOGLE_API_KEY) are never used, so one connection cannot run on another account's credentials. A connection with no key of its own is refused.

Notes and limits#

Going deeper. Every AI call made through these connections is recorded. See Audit logs. The internal prompts sent to the provider are editable in The AI prompt store.

Feedback on this page

Comments, questions, requests, or something missing or unclear? Email us - the page you are on is filled in for you.

Email feedback on this page

Or write to support@reportworq.com directly.