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.
- Connect GitHub, GitLab or Bitbucket. Configure GitHub reviews, Configure GitLab reviews and Configure Bitbucket reviews open that connection in Gateway connections.
- Enable AI review for the repositories you choose. Enable mention replies if you want to ask questions in pull request comments with
@ankraai. - 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.
2
Slack
Connect Ankra AI to Slack.
- Configure Slack workspace opens Gateway connections. Press Add to Slack and approve Ankra in Slack’s installation screen.
- Choose Ask or Agent mode for the workspace in Gateway connections. Start in Ask to investigate and explain.
- Link your personal Slack account under Your account → Connected accounts, and choose your own answer-ready messages under Your account → Notifications.
- 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.
3
Teams
Connect Ankra AI to Microsoft Teams.
- Install Ankra AI from the Microsoft Teams Store, then follow the connection steps on this page and enter the claim code Ankra AI posts.
- Choose Ask or Agent mode for the tenant in Gateway connections. Start in Ask to investigate and explain.
- Link your personal Teams account under Your account → Connected accounts, and choose your own answer-ready messages under Your account → Notifications.
- To send alerts to a Teams channel, use Send alerts to a channel on this step, as for Slack.
4
Email & personal updates
Choose the notifications you receive. This step changes your own account only.
- Review my contact email opens Your account → Profile: check that messages reach the right address.
- 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.
5
Cluster notifications
Choose where cluster notifications go.
- With Slack or Teams connected, pick a channel in Send alerts to a channel to send the recommended notifications there in one action.
- For anything else, Set notification destinations opens Integrations & alerts → Notification destinations: add a destination, such as a webhook, and send a test delivery.
- 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.
- Preview which destinations match, then send a test through the rule and check that it arrives.
Verify
- Open Ankra AI → Gateway again. Each surface you connected shows Connected, and the button reads Review the setup once all five steps are done.
- On the Set up AI Gateway page, Setup progress reads Everything here is set up.
- 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.
- 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
- Decide how far Ankra AI may go when it is asked from each connection: AI Connections.
- Check the limits you have set: What it can change without asking.