Skip to content

Commit 13e245e

Browse files
yaraya24vgrl
andauthored
Update documentation for Slack Copilot integration changes (#62066)
Co-authored-by: Vanessa <vgrl@github.com>
1 parent 266a6c2 commit 13e245e

1 file changed

Lines changed: 23 additions & 15 deletions

File tree

content/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-slack.md

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -54,45 +54,53 @@ You must have write access to the default repository – or the repository speci
5454

5555
Users can invoke {% data variables.copilot.copilot_cloud_agent %} on any repository where they have `write` access. For enterprise-owned repositories, administrators must install and configure the [Slack {% data variables.product.prodname_github_app %}](https://github.com/marketplace/slack-github?ref_product=copilot&ref_type=engagement&ref_style=text&ref_plan=enterprise) and specify which repositories the Slack app can access. For more information about configuring {% data variables.product.prodname_github_apps %}, see [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations).
5656

57-
1. In Slack, open a direct message with the {% data variables.product.prodname_github_app %} or mention the app in a thread by typing `@{% data variables.product.prodname_copilot %}`.
58-
1. Type your prompt, then send it. Optionally, you can specify a repository or branch using the following syntax:
57+
1. In Slack, open a direct message with the {% data variables.product.prodname_github_app %} or mention the app in a thread by typing `@{% data variables.product.github %}`.
58+
1. Type your prompt, then send it. You can describe the repository and branch in natural language as part of your request. For example:
5959

60-
`@{% data variables.product.github %} Add "Hello World" to the README in repo=REPO_OWNER/REPO_NAME branch=BRANCH_NAME`
60+
`@{% data variables.product.github %} Add "Hello World" to the README in octo-org/octo-repo on the develop branch`
6161

62-
> [!NOTE] The repo parameter tells {% data variables.copilot.copilot_cloud_agent %} which repository to use for the request, and the branch parameter specifies an existing branch of the repository that should be used as the base branch for a pull request. By default, {% data variables.product.prodname_copilot_short %} uses your configured default repository and the repositorys default branch.
62+
> [!NOTE] Tell {% data variables.copilot.copilot_cloud_agent %} which repository to use for the request, and, if needed, an existing branch of the repository to use as the base branch for a pull request. If you don't specify a repository, {% data variables.product.prodname_copilot_short %} uses the channel's default repository if one is set, and otherwise asks you which one to use. If you don't specify a branch, {% data variables.product.prodname_copilot_short %} creates a new branch from the repository's default branch.
6363
6464
1. {% data variables.copilot.copilot_cloud_agent %} will initiate a {% data variables.copilot.copilot_cloud_agent_short %} session and, once the {% data variables.copilot.copilot_cloud_agent_short %} has finished, respond with a summary of the changes it plans to make and a link to the pull request it has created in the default repository.
6565

66-
### Creating an issue with {% data variables.product.prodname_copilot_short %}
66+
### Creating issues with {% data variables.product.prodname_copilot_short %}
6767

68-
You can ask {% data variables.product.prodname_copilot_short %} to draft {% data variables.product.github %} issues directly from Slack, turning conversations into actionable tasks. When you mention {% data variables.product.prodname_copilot_short %}, it uses the full thread history as context for the issue it drafts. To keep the context focused, consider starting a new thread or sending a direct message.
68+
You can ask {% data variables.product.prodname_copilot_short %} to create {% data variables.product.github %} issues directly from Slack, turning conversations into actionable tasks. Just describe what you need in natural language, and {% data variables.product.prodname_copilot_short %} creates the issue for you. You can create a single issue or multiple issues at once with child-parent relationships. When you mention {% data variables.product.prodname_copilot_short %}, it uses the full thread history as context for the issues it creates. To keep the context focused, consider starting a new thread or sending a direct message.
6969

70-
1. In Slack, ask {% data variables.product.prodname_copilot_short %} to create an issue, specifying the target repository.
70+
1. In Slack, ask {% data variables.product.prodname_copilot_short %} to create one or more issues, specifying the target repository.
7171

72-
For example:
72+
To create a single issue:
7373

7474
```text
7575
@{% data variables.product.github %} In octo-org/octo-repo, create a feature request to add fuzzy matching to search.
7676
```
7777

78+
To create multiple issues at once:
79+
7880
```text
79-
@{% data variables.product.github %} Log a bug for a 500 error in octo-org/octo-repo and assign @USER to it. This happens consistently when I try to log into the site.
81+
@{% data variables.product.github %} In octo-org/octo-repo, open separate issues for adding fuzzy matching to search, paginating the results list, and caching search queries.
8082
```
8183

84+
To create issues with child-parent relationships:
85+
8286
```text
83-
@{% data variables.product.github %} In octo-org/octo-repo, create an issue and add relevant code snippets to improve the API response format.
87+
@{% data variables.product.github %} In octo-org/octo-repo, create an epic to redesign search, with child issues for fuzzy matching, pagination, and query caching.
8488
```
8589

8690
> [!NOTE] You can only use {% data variables.product.prodname_copilot_short %} to create issues in repositories where you already have permission to create issues. This feature doesn't change your access or bypass repository permissions.
8791
88-
1. Click **Review draft** to open the issue draft. {% data variables.product.prodname_copilot_short %} drafts an issue that includes:
92+
1. {% data variables.product.prodname_copilot_short %} creates the issues and replies with a link to each one. Each issue includes a title and description, and based on your prompt {% data variables.product.prodname_copilot_short %} can also add metadata such as labels, assignees, and issue type.
93+
94+
### Setting a default repository for a channel
95+
96+
To avoid specifying a repository in every request, you can set a default repository for a Slack channel.
8997

90-
* A suggested title.
91-
* Details of the required changes.
98+
1. In the channel, type `@{% data variables.product.github %} settings` and send the message.
99+
1. Select the repository you want to use as the default, then save your changes.
92100

93-
Based on your prompt, {% data variables.product.prodname_copilot_short %} can also suggest metadata such as labels, assignees, and issue type.
101+
When no repository is specified in a request, {% data variables.product.prodname_copilot_short %} uses the channel's default repository.
94102

95-
1. Review the draft, and once the issue looks good, click **Create**.
103+
> [!NOTE] The default repository is shared across the channel, so any change applies to everyone using {% data variables.product.prodname_copilot_short %} in that channel.
96104
97105

98106
## Further reading

0 commit comments

Comments
 (0)