Connect external apps to Katalon AI Assistant

Last updated: July 2026

This document explains how to connect external apps — Azure DevOps, Confluence, and Google Drive — to Katalon AI Assistant in Katalon True Platform, so the assistant can use content from those apps as context for your testing workflows.

For example, after connecting the apps your team uses, you can ask the assistant to generate test cases from a Confluence requirement page, summarize an Azure DevOps work item and its attachments, or import a PRD stored in Google Drive.

Availability Notice

External app connectors are available only for Katalon True Platform.

Requirements

• Access to Katalon AI Assistant in your Katalon True Platform project.
• An account on the external app with permission to view the content you want the assistant to use. The assistant accesses each app on your behalf and can only see what your account can see.

Supported apps

App	What the assistant can do
Azure DevOps	Read work items, Test Plans, pipelines, and pull request context — including test steps and attachments of Test Case work items; add comments to work items and pull requests; attach evidence files to an existing test run.
Confluence	Search and read pages, comments, and attachments; generate test cases from requirement pages and specs; add comments and labels to pages.
Google Drive	Import PRDs, checklists, and requirement documents; extract text from PDFs and slides; create folders and files.

Connect an app

1. In your project, open Katalon AI Assistant and start a new chat.

2. In the row of icons under the message box, click Connect apps.

   The connector list opens, showing each app with a Connect link.

3. Click Connect next to the app you want to add.

4. Sign in to the external app in the authorization dialog and grant the requested permissions.

   After the authorization completes, the app shows an enabled toggle in the connector list, and its icon appears under the message box. The assistant can now use that app in the current chat.

You connect each app once per user. The connection stays available across your chats until you disconnect it.

Use a connected app in a chat

Reference the content you want the assistant to work with directly in your message — by URL, by ID, or by name. The assistant only reads from a connected app when your request calls for it; it does not sync or scan the app in the background. If your request needs an app that isn't connected yet, the assistant tells you and points you to the Connect apps panel.

Example prompts

1. Generate test cases from this requirement page: <Confluence page URL>

With Confluence connected, the assistant reads the page, including attachments and open comments, and drafts test cases for you to review. It can save the test cases you approve to your project and turn open questions in page comments into explicit test scenarios.

Check out this example video: Generate test case from requirement page.

1. Summarize Azure DevOps work item 5924 and list its attachments

With Azure DevOps connected, the assistant combines the work item history, description, and attached screenshots into one summary. After you confirm, it can also post its findings as a comment on the work item.

3. Import the test cases from this Azure DevOps work item into my project: <work item URL>

With Azure DevOps connected, the assistant reads the Test Case work item's Steps grid as structured actions and expected results. After you approve the import, it creates a matching Katalon test case step by step.

4. Import the PRD named "Payment flows" from my Google Drive and list the acceptance criteria

With Google Drive connected, the assistant finds the named document, imports its content, and extracts the acceptance criteria for you to review.

Best practices

• Reference content explicitly — paste the URL or ID instead of describing the document. The assistant reads only what you point it to, so precise references produce precise answers.
• Scope one request to one outcome, such as "generate test cases from this page." Chain follow-up requests in the same chat instead of packing several goals into one message.
• Connect only the apps a chat needs, and use the per-chat toggle to mute the rest. A shorter tool list helps the assistant choose the right source.
• Review every write before you confirm it. The assistant shows what it is about to post, and nothing is written to a connected app without your approval.

Manage app connection

1. Under the message box, click the connected app icon.

2. To keep the app connected but stop the assistant from using it in the current chat, use the toggle to turn the app on or off.

   The change applies from your next message. When the app is turned off, the assistant tells you that it is unavailable if your request needs it.

3. To adjust the app connection:

   1. Click the settings icon next to the connected app.
   2. On the connector details page, expand the Manage menu.
   3. Click Reconnect to reload the connection.
   4. Click Disconnect to remove the connection.

Disconnecting revokes the authorization for your user. The assistant can no longer access the app until you connect it again.

To switch to a different account on the same app, disconnect it first, then connect again and sign in with the other account.

Data access and security

• Each connection is scoped to your user account. The assistant accesses the external app with your permissions only — it cannot read content that your account cannot access, and connections made by other users are never shared with you.
• Katalon does not store your credentials for the external app. Access is granted through OAuth: Katalon stores the authorization token server-side, never exposes it to your browser or chat messages, and revokes it when you disconnect the app.
• Every write action requires your explicit confirmation in the chat before the assistant performs it.

note

These per-user connectors are separate from the project-level Jira integration and Azure DevOps integration, which link requirements, defects, and sprints/releases into your Katalon True Platform project for the whole team. You can use both at the same time.

Troubleshooting

Problem	What to check
The assistant cannot find a document, page, or work item you referenced.	Verify the account you connected with can open that content in the external app. For Confluence, also confirm the connected Atlassian account belongs to the same site (for example, yourcompany.atlassian.net) that hosts the content.
The assistant tells you an app you connected earlier is unavailable.	Open Connect apps and check that the app's toggle is on and the connection is still active. Reconnect the app if it was disconnected.
A write action fails after you confirm it.	Ask the assistant for the exact error message and retry, or perform the change directly in the external app.