@groundcover Agent in Slack
Interact with groundcover's Agent directly from Slack by mentioning @groundcover in any channel
This capability is only available to BYOC deployments. Check out our pricing page for more information about subscription plans and the available deployment modes.
Once the Slack connector is set up and you have connected your personal Slack account, you can interact with groundcover's Agent from any Slack channel where the groundcover app is present by mentioning @groundcover.
This gives your team a shared interface for investigating issues, querying observability data, and triaging alerts — without leaving Slack.
How It Works
In any Slack channel where the groundcover app is present, type
@groundcoverfollowed by your question or request.The Agent processes your message and replies in a thread under your message.
You can continue the conversation in the thread — the Agent maintains context within that thread, just like a regular Agent Mode session.
The Agent in Slack has the same capabilities as Agent Mode in the groundcover UI: investigating issues, querying logs/traces/metrics, creating monitors and dashboards, and more. See Agent Mode for the full list of capabilities.
The Agent responds in a thread to keep the channel clean. All follow-up messages in that thread are part of the same conversation context.
Identity, Permissions & Budget
Every @groundcover mention is tied to the Slack user who sent the message. The Agent runs as that user's agent session, which means:
Identity
The Agent session is associated with the groundcover user whose personal Slack account matches the Slack user who sent the message
RBAC
The Agent can only access data the mentioning user is authorized to see, based on their RBAC configuration. If the user's role restricts them to specific namespaces or clusters, the Agent respects those same boundaries
Budget
The request counts against the mentioning user's Agent Mode budget. If the user has reached their monthly limit, the Agent will not process the request
Visibility: While the Agent enforces the mentioning user's permissions for data access, the Agent's response is visible to everyone in the Slack channel. Be mindful when querying sensitive data in public or broadly-shared channels — the response will be visible to all channel members, even those who may not have the same level of access in groundcover.
What Happens If You're Not Connected
If a Slack user mentions @groundcover but has not connected their personal Slack account, the Agent will respond with a message asking them to connect their account first. The Agent cannot process requests from unconnected users because it has no way to determine which groundcover user they are.
Connecting Your Personal Slack Account
Before you can use @groundcover mentions, you need to link your personal Slack account to your groundcover user. This is a one-time setup.
In groundcover, go to Integrations → Connectors → My Connections.
Find Slack and locate the Slack App for the workspace you want to connect to.
Click Connect.
You are redirected to Slack to sign in and approve access.
Once approved, you are redirected back to groundcover. Your Slack identity is now linked to your groundcover account.
You must sign into the same Slack workspace that the admin authorized during the Slack connector setup. Signing into a different workspace will fail.
To disconnect, click Disconnect on the Slack App entry in My Connections. You can reconnect at any time.
Multiple Workspaces
If your organization has multiple Slack workspaces connected, you can connect your personal account to each one independently. The Agent will respond to your mentions in any workspace where your account is linked.
Tips
Be specific — the Agent works best with clear, specific questions. Instead of "what's wrong?", try "why is the checkout service throwing 500 errors in the production cluster?"
Use threads for follow-ups — continue the conversation in the same thread to maintain context. Starting a new top-level mention creates a new, independent session.
Channel selection — use a dedicated channel (e.g.,
#groundcover-agent) for agent interactions to keep other channels focused. The Agent works in any channel it has been added to.Private channels — the Agent can respond in private channels, but it must first be invited to the channel. Run
/invite @groundcoverto add it.
Last updated
