> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/ai-agents/software-management/slack-operations-agent.md).

# Slack Operations Agent

The Slack Operations Agent is a conversational AI agent that lets you manage common Slack administrative tasks directly from your support conversation. Instead of switching between tools or submitting manual requests, you can ask the agent to perform Slack actions on your behalf, and it handles the details through a guided back-and-forth exchange.

This article covers the Slack operations currently supported, how each workflow behaves, and what to expect during the conversation.

***

### Creating a Slack Channel

You can ask the Harmony service agent to create a new Slack channel at any point during a support conversation. The agent collects everything it needs before taking action, so you do not need to have all the details ready when you make the request.

#### How the workflow works

The agent guides you through the following steps conversationally:

1. **Channel name collection and validation** - If you do not provide a channel name in your initial request, the agent asks you for one. Before proceeding, it checks whether a channel with that name already exists in your workspace, and alerts you if there is a conflict so you can choose a different name.
2. **Visibility selection** - The agent asks whether the new channel should be public or private. Public channels are visible and joinable by anyone in your workspace. Private channels are invite-only.
3. **Optional member invites** - You can specify one or more colleagues to add to the channel at the time it is created. This step is optional - if you skip it, the channel is created with you as the only member, and you can invite others later directly in Slack.
4. **Confirmation and creation** - Once the agent has all the required information, it summarises the details and asks you to confirm before creating the channel. After you confirm, the channel is created and the agent provides a direct link or confirmation message so you can navigate to it immediately.

#### Example conversation

> **You:** Can you create a new Slack channel for the Q3 launch project?
>
> **Agent:** Sure! What would you like to name the channel?
>
> **You:** q3-launch
>
> **Agent:** Got it. Should this channel be public or private?
>
> **You:** Private, please.
>
> **Agent:** Would you like to invite any team members now? If so, please share their names or email addresses.
>
> **You:** Add <alex@example.com> and <jamie@example.com>.
>
> **Agent:** Here is a summary - I will create a private channel named **#q3-launch** and invite <alex@example.com> and <jamie@example.com>. Shall I go ahead?
>
> **You:** Yes.
>
> **Agent:** Done! The channel **#q3-launch** has been created and your teammates have been invited.

#### Things to keep in mind

* Channel names must follow Slack naming rules: lowercase letters, numbers, hyphens, and underscores only, with a maximum of 80 characters.
* The agent will flag any naming issues and prompt you to adjust before continuing.
* If a channel with the requested name already exists, the agent will notify you and ask whether you want to use a different name or join the existing channel instead.
* Member invites at creation time are optional and can always be skipped.

***

### Supported Slack Operations

The table below summarises the Slack operations currently available through the conversational agent.

| Operation        | What the agent does                                                                          |
| ---------------- | -------------------------------------------------------------------------------------------- |
| Create a channel | Creates a new public or private Slack channel, with optional member invites at creation time |

Additional Slack operations will be added over time. If you need a Slack action that is not listed here, you can still submit a request through your normal support process.

***

### Getting Started

To use the Slack Operations Agent, simply start a conversation with the Harmony service agent and describe what you want to do. For example:

* "Create a new Slack channel called project-alpha."
* "Set up a private Slack channel and invite my team."
* "I need a new Slack channel for the design team."

The agent recognises these requests and initiates the appropriate guided workflow automatically. You do not need to use any special commands or syntax.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/ai-agents/software-management/slack-operations-agent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
