Skip to main content
The AI Gateway setup connects Ankra AI to your code host and your team’s chat, and routes the notifications that matter to the right place. When you finish, Ankra AI reviews pull requests in the repositories you chose, answers questions in Slack or Teams, and posts cluster notifications to a channel. The setup is a guide, not a settings page of its own: each step reads what is already connected, links to the settings page that does the work, and checks again when you come back. Moving between steps does not switch anything on. How the gateway carries a message or a pull request event to Ankra AI and back is explained in AI Gateway.

Before you start

  • Pull requests, Slack and Teams need a role that manages Ankra AI, such as owner or admin. Without it, the step reads Needs an administrator and says Ask an organisation administrator to configure this. You can still manage your personal preferences.
  • Cluster notifications need a role that manages alerts.
  • Email & personal updates is your own profile: anyone can do it.
  • For pull requests, a GitHub, GitLab or Bitbucket account that can install an app or add a connection for your repositories. See GitHub, GitLab or Bitbucket Cloud.
  • For Slack, permission to add an app to your Slack workspace. For Teams, permission to install apps from the Microsoft Teams Store; a Teams administrator is needed only if your tenant restricts Store apps.

Open the setup

Go to Ankra AI → Gateway (/next/ai/gateway). The page lists Where your team works with Ankra: Slack, Microsoft Teams, Pull requests, Watch and alert delivery, and Email and your own updates, each with a badge such as Connected or Partly connected. Press Set up the gateway. While steps are left, the button shows how many are done, for example Set up the gateway (2 of 5); once all are, it reads Review the setup. The Set up AI Gateway page opens (/next/ai/setup) with Setup progress and the five steps. Each step shows its state: Set up, Partly set up, Not set up, Could not check or Needs an administrator. Every step has the same shape: What Ankra found lists what is already connected, How to set it up lists what to do, and the links open the settings page that does it. Save on that page, then come back: the step checks again.

The steps

1

Pull requests

Set up AI reviews for pull requests.
  1. Connect GitHub, GitLab or Bitbucket. Configure GitHub reviews, Configure GitLab reviews and Configure Bitbucket reviews open that connection in Gateway connections.
  2. Enable AI review for the repositories you choose. Enable mention replies if you want to ask questions in pull request comments with @ankraai.
  3. Start in Ask mode. Automatic reviews are read-only; Agent mode also lets Ankra AI open a separate fix pull request where supported, which a person merges.
See AI code review.
2

Slack

Connect Ankra AI to Slack.
  1. Configure Slack workspace opens Gateway connections. Press Add to Slack and approve Ankra in Slack’s installation screen.
  2. Choose Ask or Agent mode for the workspace in Gateway connections. Start in Ask to investigate and explain.
  3. Link your personal Slack account under Your account → Connected accounts, and choose your own answer-ready messages under Your account → Notifications.
  4. To send alerts to a Slack channel, use Send alerts to a channel on this step: pick the Channel and the Notifications to send, then press Send these to and the channel. Ankra adds the channel as a notification destination and a routing rule for these notifications, for every cluster.
The card confirms Notifications are on their way to the channel. See AI Connections.
3

Teams

Connect Ankra AI to Microsoft Teams.
  1. Install Ankra AI from the Microsoft Teams Store, then follow the connection steps on this page and enter the claim code Ankra AI posts.
  2. Choose Ask or Agent mode for the tenant in Gateway connections. Start in Ask to investigate and explain.
  3. Link your personal Teams account under Your account → Connected accounts, and choose your own answer-ready messages under Your account → Notifications.
  4. To send alerts to a Teams channel, use Send alerts to a channel on this step, as for Slack.
Configure Microsoft Teams opens the tenant’s connection. See AI Connections.
4

Email & personal updates

Choose the notifications you receive. This step changes your own account only.
  1. Review my contact email opens Your account → Profile: check that messages reach the right address.
  2. Open my notification preferences opens Your account → Notifications: choose email subscriptions, delivery channels and the minimum severity, and whether linked Slack and Teams accounts tell you when an AI answer is ready.
Shared channel destinations and cluster routing rules are managed separately by your organisation, in the next step.
5

Cluster notifications

Choose where cluster notifications go.
  1. With Slack or Teams connected, pick a channel in Send alerts to a channel to send the recommended notifications there in one action.
  2. For anything else, Set notification destinations opens Integrations & alerts → Notification destinations: add a destination, such as a webhook, and send a test delivery.
  3. Configure cluster routing rules opens Integrations & alerts → Notification routes: create a routing rule with event kinds, severity and a cluster filter, or leave the cluster filter empty to cover all clusters.
  4. Preview which destinations match, then send a test through the rule and check that it arrives.
The step lists Cluster events to consider: Availability (an offline agent or degraded resource health), Changes (failed operations, failed deployments or GitOps sync failures), Alerts (a configured alert rule fires, with AI analysis where available) and Security (newly detected severe vulnerabilities). Pipeline run notifications are organisation events, so a cluster filter does not match them. See Notification routing.
Next step and Previous step move between steps; Finish guide on the last step returns you to Home.

Verify

  1. Open Ankra AI → Gateway again. Each surface you connected shows Connected, and the button reads Review the setup once all five steps are done.
  2. On the Set up AI Gateway page, Setup progress reads Everything here is set up.
  3. Open a pull request in a repository you enabled. Ankra AI posts its review on it, and the review is listed under Ankra AI → Code reviews.
  4. In a Slack channel the app is in, ask Ankra a question. It answers in the thread.

What can go wrong

For Ankra AI not answering at all, see Troubleshooting Ankra AI.

Next