You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/copilot/how-tos/use-copilot-agents/cloud-agent/integrate-cloud-agent-with-slack.md
+23-15Lines changed: 23 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -54,45 +54,53 @@ You must have write access to the default repository – or the repository speci
54
54
55
55
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).
56
56
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:
59
59
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`
61
61
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 repository’s 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.
63
63
64
64
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.
65
65
66
-
### Creating an issue with {% data variables.product.prodname_copilot_short %}
66
+
### Creating issues with {% data variables.product.prodname_copilot_short %}
67
67
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.
69
69
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.
71
71
72
-
For example:
72
+
To create a single issue:
73
73
74
74
```text
75
75
@{% data variables.product.github %} In octo-org/octo-repo, create a feature request to add fuzzy matching to search.
76
76
```
77
77
78
+
To create multiple issues at once:
79
+
78
80
```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.
80
82
```
81
83
84
+
To create issues with child-parent relationships:
85
+
82
86
```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.
84
88
```
85
89
86
90
> [!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.
87
91
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.
89
97
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.
92
100
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.
94
102
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.
0 commit comments