diff --git a/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md b/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md index d9578a2e5679..82cd010d17ac 100644 --- a/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md +++ b/content/account-and-profile/tutorials/using-your-github-profile-to-enhance-your-resume.md @@ -47,7 +47,7 @@ Pick 3-5 projects to highlight by "pinning" them on your profile. Repositories y For the best chances at an interview, pick projects that show your diverse skills and are relevant to your specific job search. If possible, pin some projects you created and some that you contributed to: -* Projects you own are fully under your control, so you can improve them using of the steps below. +*Projects you own are fully under your control, so you can improve them using the steps below. * Open source projects highlight your ability to collaborate with others. To pin the repositories, click **Customize your pins** in the "Popular repositories" section of your profile. diff --git a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md index 2e4e921117f6..0244089a610a 100644 --- a/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md +++ b/content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md @@ -66,7 +66,7 @@ The following are eligible for bypass access: * Repository admins, organization owners, and enterprise owners * The maintain or write role, or deploy keys. {%- ifversion ghec %} -* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#limitations-in-copilot-cloud-agents-compatibility-with-other-features). +* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github#repository-compatibility). {%- endif %} 1. In the "Bypass list" section, click **Add bypass**, then search for and select the role, team, or app you want to grant bypass permissions, and click **Add Selected**. @@ -127,7 +127,7 @@ You can grant certain roles, teams, or apps bypass permissions as well as the ab * Repository admins, organization owners, and enterprise owners * The maintain or write role, or deploy keys {%- ifversion ghec %} -* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#limitations-in-copilot-cloud-agents-compatibility-with-other-features). +* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github#repository-compatibility). {%- endif %} 1. In the "Bypass list" section, click **Add bypass**, then search for and select the role, team, or app you want to grant bypass permissions, and click **Add Selected**. diff --git a/content/code-security/concepts/code-scanning/autofix-for-code-scanning.md b/content/code-security/concepts/code-scanning/autofix-for-code-scanning.md index f5f5fdd3e817..86f9546675f2 100644 --- a/content/code-security/concepts/code-scanning/autofix-for-code-scanning.md +++ b/content/code-security/concepts/code-scanning/autofix-for-code-scanning.md @@ -31,7 +31,7 @@ Assign a {% data variables.product.prodname_code_scanning %} alert to {% data va Keep the following in mind: * Agentic autofix requires {% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_autofix_short %} to be available in the repository. If {% data variables.copilot.copilot_cloud_agent %} isn't available, assigning an alert falls back to {% data variables.copilot.copilot_autofix_short %} instead. -* Each agentic autofix session is billed as a {% data variables.copilot.copilot_cloud_agent %} session and consumes {% data variables.product.prodname_ai_credits_short %}. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#copilot-cloud-agent-usage-costs). +* Each agentic autofix session is billed as a {% data variables.copilot.copilot_cloud_agent %} session and consumes {% data variables.product.prodname_ai_credits_short %}. See [AUTOTITLE](/copilot/concepts/billing-and-usage). * {% data variables.product.prodname_copilot_short %} follows any custom instructions configured for the repository or organization when it generates a fix. * Agentic autofix works on a best-effort basis. {% data variables.product.prodname_copilot_short %} validates fixes by re-running {% data variables.product.prodname_codeql %} using the code-scanning query suite, so it can't confirm that a fix resolves alerts generated by custom queries or the security-extended query suite. Fix quality for alerts from third-party tools is also not guaranteed. diff --git a/content/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts/resolve-alerts.md b/content/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts/resolve-alerts.md index ac25f0aa4495..cc8175ce5395 100644 --- a/content/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts/resolve-alerts.md +++ b/content/code-security/how-tos/manage-security-alerts/manage-code-scanning-alerts/resolve-alerts.md @@ -40,7 +40,7 @@ With a {% data variables.copilot.copilot_enterprise %} license, you can ask {% d You can assign a {% data variables.product.prodname_code_scanning %} alert to {% data variables.product.prodname_copilot_short %} to have it fix the alert for you. Assigning the alert starts an agent session: {% data variables.copilot.copilot_cloud_agent %} explores your codebase, generates a fix, validates it, and opens a pull request. -Each agentic autofix session is billed as a {% data variables.copilot.copilot_cloud_agent %} session and consumes {% data variables.product.prodname_ai_credits_short %}. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#copilot-cloud-agent-usage-costs). +Each agentic autofix session is billed as a {% data variables.copilot.copilot_cloud_agent %} session and consumes {% data variables.product.prodname_ai_credits_short %}. See [AUTOTITLE](/copilot/concepts/billing-and-usage). To assign an individual alert to {% data variables.product.prodname_copilot_short %}: diff --git a/content/copilot/concepts/agents/about-third-party-coding-agents.md b/content/copilot/concepts/agents/about-third-party-coding-agents.md index 7a06b5525510..c24226a904b7 100644 --- a/content/copilot/concepts/agents/about-third-party-coding-agents.md +++ b/content/copilot/concepts/agents/about-third-party-coding-agents.md @@ -17,7 +17,7 @@ redirect_from: You can use third-party coding agents alongside {% data variables.copilot.copilot_cloud_agent %} to work asynchronously on your development tasks. You can assign an existing issue or give a prompt to an agent, which will work on the required changes and create a pull request. When the agent finishes, it will request a review from you, and you can leave pull request comments to ask the agent to iterate. -Coding agents are subject to the same security protections, mitigations, and limitations as {% data variables.copilot.copilot_cloud_agent %}. To learn more about how you can use coding agents, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +Coding agents are subject to the same security protections, mitigations, and limitations as {% data variables.copilot.copilot_cloud_agent %}. To learn more about how you can use coding agents, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ### Where you can use coding agents diff --git a/content/copilot/concepts/agents/agent-apps.md b/content/copilot/concepts/agents/agent-apps.md index 28032916b5c6..44e3733cd614 100644 --- a/content/copilot/concepts/agents/agent-apps.md +++ b/content/copilot/concepts/agents/agent-apps.md @@ -13,7 +13,7 @@ contentType: concepts ## Introduction -{% data reusables.copilot.agent-apps-intro %} {% data variables.copilot.agent_apps_caps %} are powered by {% data variables.copilot.copilot_cloud_agent %}. To learn more, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +{% data reusables.copilot.agent-apps-intro %} {% data variables.copilot.agent_apps_caps %} are powered by {% data variables.copilot.copilot_cloud_agent %}. To learn more, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). For example, an {% data variables.copilot.agent_app %} could analyze your product analytics, scan your application for security vulnerabilities, or add feature flags to a pull request, then connect back to the partner's systems to complete the task. diff --git a/content/copilot/concepts/agents/cloud-agent/about-automations.md b/content/copilot/concepts/agents/cloud-agent/about-automations.md index 2eb26a35eb06..35977b1cf690 100644 --- a/content/copilot/concepts/agents/cloud-agent/about-automations.md +++ b/content/copilot/concepts/agents/cloud-agent/about-automations.md @@ -111,5 +111,5 @@ For more information about how {% data variables.product.github %} mitigates the ## Further reading * [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/create-automations) -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * To learn how to store your automation as code, review it through pull requests, or run it with a different coding agent, see [AUTOTITLE](/copilot/concepts/agents/about-github-agentic-workflows) diff --git a/content/copilot/concepts/agents/cloud-agent/about-cloud-agent.md b/content/copilot/concepts/agents/cloud-agent/about-cloud-agent.md deleted file mode 100644 index 983d1895ad0c..000000000000 --- a/content/copilot/concepts/agents/cloud-agent/about-cloud-agent.md +++ /dev/null @@ -1,174 +0,0 @@ ---- -title: About GitHub Copilot cloud agent -shortTitle: About cloud agent -allowTitleToDifferFromFilename: true -intro: '{% data variables.product.prodname_copilot_short %} can research a repository, create an implementation plan, and make code changes on a branch. You can review the diff, iterate, and create a pull request when you''re ready.' -product: '{% data reusables.gated-features.copilot-cloud-agent %}
Sign up for {% data variables.product.prodname_copilot_short %} {% octicon "link-external" height:16 %}' -versions: - feature: copilot -redirect_from: - - /copilot/concepts/agents/coding-agent/about-coding-agent - - /copilot/concepts/about-assigning-tasks-to-copilot - - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/about-assigning-tasks-to-copilot - - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/about-assigning-issues-to-copilot - - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/about-assigning-tasks-to-copilot - - /copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot - - /copilot/concepts/about-copilot-coding-agent - - /copilot/concepts/coding-agent/about-copilot-coding-agent - - /copilot/concepts/coding-agent/coding-agent -contentType: concepts -category: - - Learn about Copilot ---- - -## Overview of {% data variables.copilot.copilot_cloud_agent %} - -With {% data variables.copilot.copilot_cloud_agent %}, {% data variables.product.prodname_copilot %} can work independently in the background to complete tasks, just like a human developer. - -{% data variables.copilot.copilot_cloud_agent %} can: - -* Research a repository -* Create implementation plans -* Fix bugs -* Implement incremental new features -* Improve test coverage -* Update documentation -* Address technical debt -* Resolve merge conflicts - -When you delegate tasks to {% data variables.copilot.copilot_cloud_agent %}, you can: - -* Use the agents panel or other agents entry points on {% data variables.product.prodname_dotcom_the_website %} to have {% data variables.product.prodname_copilot_short %} research, plan, and make code changes on a branch, then iterate before creating a pull request. You can also specify in your prompt that you want a pull request created right away. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate). -* Ask {% data variables.product.prodname_copilot_short %} to open a new pull request from other entry points, including {% data variables.product.prodname_github_issues %} and {% data variables.product.prodname_vscode %}. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions). -* Mention `@copilot` in a comment on an existing pull request to ask it to make changes. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github). -* Set up an {% data variables.copilot.copilot_automation %} to run {% data variables.product.prodname_copilot_short %} automatically, on a schedule or in response to events such as an issue being opened. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-automations). -{% ifversion security-campaigns-assign-to-cca %}* Assign security alerts to {% data variables.product.prodname_copilot_short %} from security campaigns. See [AUTOTITLE](/code-security/how-tos/manage-security-alerts/remediate-alerts-at-scale/fixing-alerts-in-security-campaign#assigning-alerts-to-copilot-cloud-agent).{% endif %} - -{% data variables.copilot.copilot_cloud_agent %} will evaluate the task it has been assigned based on the prompt you give it. - -While working on a coding task, {% data variables.copilot.copilot_cloud_agent %} has access to its own ephemeral development environment, powered by {% data variables.product.prodname_actions %}, where it can explore your code, make changes, execute automated tests and linters and more. - -> [!NOTE] Deep research, planning, and iterating on code changes before creating a pull request are only available with {% data variables.copilot.copilot_cloud_agent %} on {% data variables.product.prodname_dotcom_the_website %}, and in {% data variables.release-phases.public_preview %} for the Microsoft Teams and Slack integrations. Other {% data variables.copilot.copilot_cloud_agent_short %} integrations (such as Azure Boards, JIRA, or Linear) only support creating a pull request directly. - -### Benefits over traditional AI workflows - -When used effectively, {% data variables.copilot.copilot_cloud_agent %} offers productivity benefits over traditional AI assistants in IDEs: - -* With **AI assistants in IDEs**, coding happens **locally**. Individual developers pair in **synchronous** sessions with the AI assistant. Decisions made during the session are **untracked** and lost to time unless committed. Although the assistant helps write code, the developer still has a lot of **manual steps** to do: create the branch, write commit messages, push the changes, open the PR, write the PR description, get a review, iterate in the IDE, and repeat. These steps take time and effort that may be hard to justify for simple or routine issues. - -* With **{% data variables.copilot.copilot_cloud_agent %}**, all coding and iterating happens **on {% data variables.product.github %}**. You can ask {% data variables.product.prodname_copilot_short %} to **research** a repository, **create a plan**, and **make code changes** on a branch—all before opening a pull request. You can create multiple {% data variables.copilot.custom_agents_short %} that specialize in different types of tasks. {% data variables.product.prodname_copilot_short %} **automates** branch creation, commit message writing, and pushing. Developers let the agents **work in the background** and then chooses to **create a pull request** when ready. Working on {% data variables.product.github %} adds **transparency**, with every step happening in a commit and being viewable in logs, and opens up **collaboration** opportunities for the entire team. - -### Sharing context between {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_cloud_agent %} sessions - -When you start a {% data variables.copilot.copilot_cloud_agent %} session from {% data variables.copilot.copilot_chat_short %} on {% data variables.product.github %}, the session carries the context of your chat. You can continue chatting while the session runs, and ask follow-up questions about progress in the same conversation. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents). - -## {% data variables.copilot.copilot_cloud_agent %} versus agent mode - -{% data variables.copilot.copilot_cloud_agent %} is distinct from the "agent mode" feature available in your IDE. {% data variables.copilot.copilot_cloud_agent %} works autonomously in a {% data variables.product.prodname_actions %}-powered environment to complete development tasks assigned through {% data variables.product.github %} issues or {% data variables.copilot.copilot_chat %} prompts. It can research a repository, create a plan, make code changes on a branch, and optionally open a pull request. In contrast, agent mode in your IDE makes autonomous edits directly in your local development environment. For more information about agent mode, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide). - -## Streamlining software development with {% data variables.copilot.copilot_cloud_agent %} - -Assigning tasks to {% data variables.copilot.copilot_cloud_agent %} can enhance your software development workflow. - -For example, you can assign {% data variables.copilot.copilot_cloud_agent %} to straightforward issues on your backlog by selecting "{% data variables.product.prodname_copilot_short %}" as the assignee. This allows you to spend less time on these issues and more time on more complex or interesting work, or work that requires a high degree of creative thinking. {% data variables.copilot.copilot_cloud_agent %} can work on "nice to have" issues that improve the quality of your codebase or product, but often remain on the backlog while you focus on more urgent work. - -Having {% data variables.copilot.copilot_cloud_agent %} as an additional coding resource also allows you to start tasks that you might not have otherwise started due to lack of resources. For example, you might create issues to refactor code or add more logging, and then immediately assign these to {% data variables.product.prodname_copilot_short %}. - -You can also use {% data variables.copilot.copilot_cloud_agent %} to research a repository and create a plan before any code is written, helping you understand how a codebase works or agree on an approach before committing to changes. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate). - -{% data variables.copilot.copilot_cloud_agent %} can start a task, which you then pick up and continue working on yourself. By assigning the initial work to {% data variables.product.prodname_copilot_short %}, you free up time that you would otherwise have spent doing repetitive tasks, such as setting up the scaffolding for a new project. - -You can create specialized {% data variables.copilot.custom_agents_short %} for different tasks. For example, you might create a {% data variables.copilot.copilot_custom_agent_short %} specialized for frontend development that focuses on React components and styling, a documentation agent that excels at writing and updating technical documentation, or a testing agent that specializes in generating comprehensive unit tests. Each {% data variables.copilot.copilot_custom_agent_short %} can be tailored with specific prompts and tools suited to its particular task. - -## Measuring pull request outcomes for {% data variables.copilot.copilot_cloud_agent %} - -Enterprise administrators and organization owners can use {% data variables.product.prodname_copilot_short %} usage metrics to analyze pull request outcomes for pull requests created by {% data variables.copilot.copilot_cloud_agent %}. - -The {% data variables.product.prodname_copilot_short %} usage metrics APIs include pull request lifecycle metrics such as: - -* The total number of pull requests created and merged -* The number of pull requests created by {% data variables.copilot.copilot_cloud_agent %} that have been merged -* Median time to merge for merged pull requests, including pull requests created by {% data variables.copilot.copilot_cloud_agent %} - -These metrics can help you track adoption of {% data variables.copilot.copilot_cloud_agent %} and monitor changes in pull request throughput and time to merge over time. See [AUTOTITLE](/copilot/concepts/billing-and-usage/copilot-usage-metrics/copilot-metrics). - -## Integrating {% data variables.copilot.copilot_cloud_agent %} with third-party tools - -You can invoke {% data variables.copilot.copilot_cloud_agent %} from external tools, allowing you to assign tasks to {% data variables.product.prodname_copilot_short %}, provide context, and open pull requests without leaving your workflow. - -Use {% data variables.copilot.copilot_cloud_agent %} in Microsoft Teams and Slack to collaborate with your team on agent-assisted work. You can @mention {% data variables.product.github %} in channels, threads, and direct messages to work alongside teammates and {% data variables.product.prodname_copilot_short %} on research, planning, and coding tasks. Teammates can add context, steer {% data variables.product.prodname_copilot_short %} sessions, monitor progress, and then review the resulting artifacts. - -For more information, see [AUTOTITLE](/copilot/concepts/tools/about-copilot-integrations). - -## Making {% data variables.copilot.copilot_cloud_agent %} available - -Before you can assign tasks to {% data variables.copilot.copilot_cloud_agent %}, it must be enabled. {% data variables.copilot.copilot_cloud_agent %} is available for all paid {% data variables.product.prodname_copilot_short %} plans. - -If you are a {% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %} subscriber, an administrator must enable the relevant policy before you can use the agent. - -Repository owners can choose to opt out some or all repositories from {% data variables.copilot.copilot_cloud_agent %}. - -See [AUTOTITLE](/copilot/concepts/enterprise/cloud-agent-access). - -## AI models for {% data variables.copilot.copilot_cloud_agent %} - -Depending on how you start your {% data variables.copilot.copilot_cloud_agent %} task, you may be able to select the model used by {% data variables.copilot.copilot_cloud_agent %}. You may find that different models perform better, or provide more useful responses, depending on the type of tasks you give {% data variables.product.prodname_copilot_short %}. - -See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). - -## Enhancing {% data variables.copilot.copilot_cloud_agent %}'s knowledge of a repository - -The more {% data variables.copilot.copilot_cloud_agent %} knows about the code in your repository, the tools you use, and your coding standards and practices, the more effective it will become. There are two ways you can enhance {% data variables.copilot.copilot_cloud_agent %}'s knowledge of a repository. - -* **Custom instructions** - - These are short, natural‑language statements that you write and store as one or more files in a repository. If you are the owner of an organization on {% data variables.product.github %} you can also define custom instructions in the settings for your organization. See [AUTOTITLE](/copilot/concepts/prompting/response-customization?tool=webui#about-repository-custom-instructions). - -* **{% data variables.copilot.copilot_memory %}** ({% data variables.release-phases.public_preview %}) - - If you have a {% data variables.copilot.copilot_pro_short %}, {% data variables.copilot.copilot_pro_plus_short %}, or {% data variables.copilot.copilot_max_short %} plan, you can enable {% data variables.copilot.copilot_memory %}. This allows {% data variables.product.prodname_copilot_short %} to store useful details it has worked out for itself about a repository. {% data variables.copilot.copilot_cloud_agent %} can then use this information when it is working in that repository. See [AUTOTITLE](/copilot/concepts/agents/copilot-memory). - -## {% data variables.copilot.copilot_cloud_agent %} usage costs - -{% data variables.copilot.copilot_cloud_agent %} uses {% data variables.product.prodname_actions %} minutes and {% data variables.product.prodname_ai_credits_short %}. The {% data variables.product.prodname_ai_credits_short %} consumed depend on the model used and the number of tokens processed during the session. - -Within your included {% data variables.product.prodname_actions %} minutes and {% data variables.product.prodname_ai_credits_short %}, you can use {% data variables.copilot.copilot_cloud_agent %} without incurring additional costs. See [AUTOTITLE](/copilot/concepts/billing-and-usage/organizations-and-enterprises/billing). - -{% data variables.product.prodname_copilot_short %} code review also consumes {% data variables.product.prodname_actions %} minutes on private repositories. See [AUTOTITLE](/billing/concepts/product-billing/github-actions#copilot-code-review-and-github-actions-minutes). - -## Customizing {% data variables.copilot.copilot_cloud_agent %} - -You can customize {% data variables.copilot.copilot_cloud_agent %} in a number of ways: - -* **Custom instructions**: Custom instructions allow you to give {% data variables.product.prodname_copilot_short %} additional context on your project and how to build, test and validate its changes. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions). -* **Model Context Protocol (MCP) servers**: MCP servers allow you to give {% data variables.product.prodname_copilot_short %} access to different data sources and tools. Repository MCP settings on {% data variables.product.github %} apply to both {% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_code-review_short %}. The {% data variables.product.github %} MCP server and Playwright MCP server are enabled by default for both features. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers). -* **{% data variables.copilot.custom_agents_caps_short %}**: {% data variables.copilot.custom_agents_caps_short %} allow you to create different specialized versions of {% data variables.product.prodname_copilot_short %} for different tasks. For example, you could customize {% data variables.product.prodname_copilot_short %} to be an expert frontend engineer following your team's guidelines. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents). -* **Hooks**: Hooks allow you to execute custom shell commands at key points during agent execution, enabling you to add validation, logging, security scanning, or workflow automation. See [AUTOTITLE](/copilot/concepts/agents/hooks). -* **Skills**: Skills allow you to enhance the ability of {% data variables.product.prodname_copilot_short %} to perform specialized tasks with instructions, scripts, and resources. See [AUTOTITLE](/copilot/concepts/agents/about-agent-skills). - -## Limitations of {% data variables.copilot.copilot_cloud_agent %} - -{% data variables.copilot.copilot_cloud_agent %} has certain limitations in its software development workflow and compatibility with other features. - -### Limitations in {% data variables.copilot.copilot_cloud_agent %}'s software development workflow - -* **{% data variables.product.prodname_copilot_short %} can only make changes in the repository specified when you start a task**. {% data variables.product.prodname_copilot_short %} cannot make changes across multiple repositories in one run. -* **By default, {% data variables.product.prodname_copilot_short %} can only access context in the repository specified when you start a task**. The {% data variables.product.prodname_copilot_short %} MCP server is configured by default to allow {% data variables.product.prodname_copilot_short %} to access context (for example issues and historic pull requests) in the repository where it is working. You can, however, configure broader access through repository MCP settings. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers). -* **{% data variables.product.prodname_copilot_short %} can only work on one branch at a time** and can open exactly one pull request to address each task it is assigned. -* **Each {% data variables.copilot.copilot_cloud_agent %} session has a maximum execution time of 59 minutes**. This is a hard limit that cannot be extended or bypassed. If a task exceeds this limit, the session will time out and stop. For complex tasks that may require more time, consider breaking the work into smaller, more focused tasks. You can configure a shorter timeout using the `timeout-minutes` setting in your `copilot-setup-steps.yml` file. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment). - -### Limitations in {% data variables.copilot.copilot_cloud_agent %}'s compatibility with other features - -* **{% data variables.product.prodname_copilot_short %} isn't able to comply with certain rules that may be configured for your repository**. If you have configured a ruleset or branch protection rule that isn't compatible with {% data variables.copilot.copilot_cloud_agent %}, access to the agent will be blocked. For example, a rule that only allows specific commit authors can prevent {% data variables.copilot.copilot_cloud_agent %} from creating or updating pull requests. If the rule is configured using rulesets, you can add {% data variables.product.prodname_copilot_short %} as a bypass actor to enable access. See [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository#granting-bypass-permissions-for-your-branch-or-tag-ruleset). -* **{% data variables.copilot.copilot_cloud_agent %} only works with repositories hosted on {% data variables.product.github %}**. If your repository is stored using a different code hosting platform, {% data variables.product.prodname_copilot_short %} won't be able to work on it. - -## Hands-on practice - -Try the [Expand your team with {% data variables.copilot.copilot_cloud_agent %}](https://github.com/skills/expand-your-team-with-copilot/?ref_product=copilot&ref_type=engagement&ref_style=text) Skills exercise for practical experience with {% data variables.copilot.copilot_cloud_agent %}. - -## Further reading - -* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent) how-to articles -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents) -* [AUTOTITLE](/copilot/responsible-use/agents) -* [AUTOTITLE](/copilot/concepts/agents/about-github-agentic-workflows) for recurring repository automation that you want to version with your code and run in {% data variables.product.prodname_actions %} diff --git a/content/copilot/concepts/agents/cloud-agent/agent-management.md b/content/copilot/concepts/agents/cloud-agent/agent-management.md index f27aff08a793..837479d07b04 100644 --- a/content/copilot/concepts/agents/cloud-agent/agent-management.md +++ b/content/copilot/concepts/agents/cloud-agent/agent-management.md @@ -28,7 +28,7 @@ Utilizing {% data variables.copilot.custom_agents_short %} you can build out a t Model choice allows you to choose from a selection of AI models to use with your agents, each with its own particular strengths. See [AUTOTITLE](/copilot/reference/ai-models/supported-models). -To learn more about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +To learn more about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Managing agents diff --git a/content/copilot/concepts/agents/cloud-agent/index.md b/content/copilot/concepts/agents/cloud-agent/index.md index fc3c2d1aff64..ed9b67eb0401 100644 --- a/content/copilot/concepts/agents/cloud-agent/index.md +++ b/content/copilot/concepts/agents/cloud-agent/index.md @@ -6,7 +6,6 @@ intro: Learn how {% data variables.copilot.copilot_cloud_agent %} can carry out versions: feature: copilot children: - - /about-cloud-agent - /agent-management - /about-custom-agents - /about-automations diff --git a/content/copilot/concepts/agents/copilot-cli/comparing-cli-features.md b/content/copilot/concepts/agents/copilot-cli/comparing-cli-features.md index 94f46af20e71..c9fd744d9e7c 100644 --- a/content/copilot/concepts/agents/copilot-cli/comparing-cli-features.md +++ b/content/copilot/concepts/agents/copilot-cli/comparing-cli-features.md @@ -170,7 +170,7 @@ You’ll see {% data variables.product.prodname_copilot_short %} using tools whe ### Find out more about allowing or denying tools -See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli#allowed-tools). +See [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli#allowed-tools). ## MCP servers diff --git a/content/copilot/concepts/agents/copilot-cli/index.md b/content/copilot/concepts/agents/copilot-cli/index.md index 8a5a181db4b1..05e30130703b 100644 --- a/content/copilot/concepts/agents/copilot-cli/index.md +++ b/content/copilot/concepts/agents/copilot-cli/index.md @@ -6,7 +6,6 @@ intro: Learn how you can use {% data variables.product.prodname_copilot %} in yo versions: feature: copilot children: - - /about-copilot-cli - /comparing-cli-features - /copilot-cli-in-github-actions - /cancel-and-roll-back diff --git a/content/copilot/concepts/agents/copilot-in-jetbrains.md b/content/copilot/concepts/agents/copilot-in-jetbrains.md deleted file mode 100644 index be067ffd4976..000000000000 --- a/content/copilot/concepts/agents/copilot-in-jetbrains.md +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: Using GitHub Copilot in JetBrains IDEs -shortTitle: Copilot in JetBrains -intro: 'Learn about the different ways to use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_jetbrains_ides %}, including the {% data variables.product.prodname_copilot %} plugin, JetBrains AI Assistant, and {% data variables.copilot.copilot_cli_short %}.' -versions: - feature: copilot -contentType: concepts -category: - - Learn about Copilot -allowTitleToDifferFromFilename: true ---- - -## Introduction - -There are three ways to use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_jetbrains_ides %}: the {% data variables.product.prodname_copilot %} plugin, {% data variables.product.prodname_copilot %} as an agent in JetBrains AI Assistant, and {% data variables.copilot.copilot_cli %} in the integrated terminal. Each entry point provides a different set of capabilities depending on how you prefer to work. - -## Comparing entry points - -| | {% data variables.product.prodname_copilot %} plugin | {% data variables.product.prodname_copilot %} in AI Assistant | {% data variables.copilot.copilot_cli_short %} | -|---|---|---|---| -| **Best for** | Comprehensive AI coding workflow | Quick {% data variables.product.prodname_copilot_short %} access without a separate plugin | Terminal-first workflows | -| **Entry point** | Chat panel, inline chat, code suggestions, code review, commit message | Default agent picker, ACP Registry | Terminal or shell | -| **Code completion** | Yes | Not included | Not included | -| **Next edit suggestions** | Yes | Coming soon | Not included | -| **Agentic experience** | Multiple agent harnesses | {% data variables.product.prodname_copilot_short %} as agent via ACP, Default agent picker | {% data variables.copilot.copilot_cli_short %} | -| **IDE tools** | Yes | Yes | Not included | -| **Model selection** | Yes | Yes | Yes | -| **Inline chat** | Yes | Not included | Not included | -| **Code review** | Yes | Not included | Not included | -| **Commit message generation** | Yes | Not included | Not included | -| **Subscription** | {% data variables.product.prodname_copilot %} | {% data variables.product.prodname_copilot %} | {% data variables.product.prodname_copilot %} | - -## {% data variables.product.prodname_copilot %} plugin - -The {% data variables.product.prodname_copilot %} plugin for {% data variables.product.prodname_jetbrains_ides %} is the most comprehensive way to use {% data variables.product.prodname_copilot_short %} and is the recommended choice. - -The plugin is transitioning from its local agent harness to {% data variables.copilot.copilot_agent_short %} as the default agent harness, which brings faster feature parity and higher-quality results. For installation instructions, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/set-up-copilot/install-copilot-extension). - -The {% data variables.product.prodname_copilot %} plugin provides the following capabilities. - -* **Full model and feature support**: All {% data variables.copilot.copilot_chat_short %} models, code completion modes, and bring-your-own-key features are available as they are released. -* **Code completion and next edit suggestions**: {% data variables.product.prodname_copilot_short %} suggests completions as you type and proactively predicts your next intended edit. -* **Commit message generation**: {% data variables.product.prodname_copilot_short %} inspects your staged changes and generates a clear, conventional commit message. -* **Inline chat**: Explain, refactor, document, or generate code directly in the editor gutter, without switching to a separate panel. -* **Code review**: {% data variables.product.prodname_copilot_short %} analyzes your changes and surfaces actionable feedback, flagging potential bugs, style violations, and logic issues. -* **Multiple agent harnesses**: The plugin ships its own agent experience and partners with other agent providers, giving you multiple interaction modes. -* **Sandbox support** ({% data variables.release-phases.public_preview %}): Isolated execution environments for {% data variables.product.prodname_copilot_short %} to safely interact with code, tools, filesystem, and network resources. -* **OpenTelemetry**: Analyze agent sessions and understand agent usage across an enterprise. -* **Enterprise managed settings**: Apply consistent controls for everyone on your enterprise’s {% data variables.product.prodname_copilot_short %} plan, including plugins and MCP management, OpenTelemetry settings, and permission control. - -## {% data variables.product.prodname_copilot %} in JetBrains AI Assistant - -> [!NOTE] -> {% data variables.product.prodname_copilot %} in AI Assistant provides chat and agent capabilities only. It does not include code completion, next edit suggestions, inline chat, code review, or commit message generation. - -{% data variables.product.prodname_copilot %} is available as a native agent in JetBrains AI Assistant through the Agent Client Protocol (ACP). The ACP is an open standard for connecting AI agents to the IDE. If you have a valid {% data variables.product.prodname_copilot_short %} subscription, {% data variables.product.prodname_copilot_short %} appears in the AI Assistant agent picker automatically. - -This integration is designed for developers who prefer to work inside the AI Assistant chat panel or who want {% data variables.product.prodname_copilot_short %} available without installing an additional plugin. - -* **No updates required**: The {% data variables.product.prodname_copilot_short %} agent is bundled directly with AI Assistant and kept current automatically. No separate plugin to install, update, or maintain. -* **Chat-centric workflow**: Ideal for multi-step reasoning tasks—describe a goal, let {% data variables.product.prodname_copilot_short %} plan and propose changes, and iterate conversationally. -* **Model selection**: Switch {% data variables.product.prodname_copilot_short %} models or adjust reasoning depth without leaving the chat panel. - -### Using {% data variables.product.prodname_copilot %} in AI Assistant - -1. Open JetBrains AI Assistant by pressing Alt+A (Windows/Linux) or Command+Shift+A (macOS), or click the AI Assistant icon in the right tool window. -1. In the agent picker dropdown at the top of the chat panel, select **{% data variables.product.prodname_copilot %}**. -1. Enter a prompt and start chatting. - -### The ACP Registry - -The ACP Registry is the catalog of agents that AI Assistant knows about. When the IDE starts, it consults the registry to discover which agents are available. {% data variables.product.prodname_copilot %}'s ACP entry is part of the default registry, so {% data variables.product.prodname_copilot_short %} appears in your agent list automatically when you have a valid subscription and the required credentials in place. - -For more information about ACP, see the [ACP documentation](https://agentclientprotocol.com/get-started/introduction). For technical details on running {% data variables.copilot.copilot_cli_short %} as an ACP server, see [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server). - -## {% data variables.copilot.copilot_cli %} in the integrated terminal - -{% data variables.copilot.copilot_cli %} brings {% data variables.product.prodname_copilot_short %}'s capabilities directly to the terminal. It is optimized for command-line workflows and can run on macOS, Linux, or Windows. - -## Further reading - -* [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide) -* [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/set-up-copilot/install-copilot-extension) -* [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/change-the-chat-model) diff --git a/content/copilot/concepts/agents/index.md b/content/copilot/concepts/agents/index.md index 26997922e67e..c13ee71cbc24 100644 --- a/content/copilot/concepts/agents/index.md +++ b/content/copilot/concepts/agents/index.md @@ -8,10 +8,8 @@ versions: children: - /cloud-agent - /copilot-cli - - /github-copilot-app - - /computer-use - - /copilot-in-jetbrains - /code-review + - /computer-use - /about-github-agentic-workflows - /copilot-memory - /dynamic-workflows diff --git a/content/copilot/concepts/chat.md b/content/copilot/concepts/chat.md deleted file mode 100644 index 12a385003f0f..000000000000 --- a/content/copilot/concepts/chat.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: About GitHub Copilot Chat -shortTitle: Chat -intro: 'Learn how you can use {% data variables.copilot.copilot_chat %} to enhance your coding experience.' -versions: - feature: copilot -redirect_from: - - /copilot/concepts/about-github-copilot-chat - - /copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat -contentType: concepts -category: - - Learn about Copilot ---- - -# Overview - -{% data variables.copilot.copilot_chat %} is the AI-powered chat interface for {% data variables.product.prodname_copilot %}. It allows you to interact with AI models to get coding assistance, explanations, and suggestions in a conversational format. - -{% data variables.copilot.copilot_chat_short %} can help you with a variety of coding-related tasks, like offering you code suggestions, providing natural language descriptions of a piece of code's functionality and purpose, generating unit tests for your code, and proposing fixes for bugs in your code. - -{% data variables.copilot.copilot_chat %} is available in various environments: - -* {% data variables.product.github %} (the website) -* A range of IDEs such as {% data variables.product.prodname_vscode %}, Xcode, and JetBrains IDEs -* {% data variables.product.prodname_mobile %} -* {% data variables.copilot.copilot_cli %} -* {% data variables.copilot.github_copilot_app %} - -Different environments may have different features and capabilities, but the core functionality remains consistent across platforms. To explore the functionality available in each environment, see the [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot) and [AUTOTITLE](/copilot/how-tos/copilot-on-github/chat-with-copilot) how-to guides and the [AUTOTITLE](/copilot/tutorials). - -## Limitations - -{% data variables.copilot.copilot_chat_short %} is designed to assist with coding tasks, but you remain responsible for reviewing and validating the code it generates. It may not always produce correct or optimal solutions, and it can sometimes generate code that contains security vulnerabilities or other issues. Always test and review the code before using it in production. - -## Passing context between {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_cloud_agent %} sessions - -On {% data variables.product.github %}, {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_cloud_agent %} can share context. When you start an agent session from a chat, the session incorporates the context of your conversation, and while the session runs you can continue chatting with {% data variables.product.prodname_copilot_short %} about its progress. - -{% data variables.copilot.copilot_chat_short %} can also answer questions about pull requests created by {% data variables.product.prodname_copilot_short %} by pulling in the relevant agent session logs, so you can ask what changed, what was validated, and why, without leaving the conversation. - -This context passing is scoped to the {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_cloud_agent_short %} sessions you are actively working with. It is distinct from {% data variables.copilot.copilot_memory %}, which builds a longer-term, persistent understanding of your repositories and preferences across sessions. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents). - -## Customizing {% data variables.copilot.copilot_chat_short %} responses - -{% data variables.product.prodname_copilot %} in {% data variables.product.github %}, {% data variables.product.prodname_vscode %}, and {% data variables.product.prodname_vs %} can provide chat responses that are tailored to the way your team works, the tools you use, the specifics of your project, or your personal preferences, if you provide it with enough context to do so. Instead of repeating instructions in each prompt, you can create and save instructions for {% data variables.copilot.copilot_chat_short %} to customize what responses you receive. - -There are various ways you can create custom instructions for {% data variables.copilot.copilot_chat_short %}. These fall into three main categories: - -* **Personal instructions**: You can add personal instructions so that all the chat responses you, as a user, receive are tailored to your preferences. -* **Repository instructions**: You can store instructions files in a repository, so that all prompts asked in the context of the repository automatically include the instructions you've defined. -* **Organization instructions**: If you are an organization owner, you can create a custom instructions file for an organization, so that all prompts asked in the context of any repository owned by the organization automatically include the instructions you've defined. - -For more information, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-personal-instructions), [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions) and [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-organization-instructions). - -## AI models for {% data variables.copilot.copilot_chat_short %} - -{% data reusables.copilot.change-the-ai-model %} - -## Extending {% data variables.copilot.copilot_chat_short %} - -{% data variables.copilot.copilot_chat_short %} can be extended in a variety of ways to enhance its functionality and integrate it with other tools and services. This can include using the Model Context Protocol (MCP) to provide context-aware AI assistance, or connecting third-party tools to leverage {% data variables.product.github %}’s AI capabilities. - -### Extending {% data variables.copilot.copilot_chat_short %} with MCP - -MCP is an open standard that defines how applications share context with large language models (LLMs). MCP provides a standardized way to connect AI models to different data sources and tools, enabling them to work together more effectively. - -You can configure MCP servers to provide context to {% data variables.copilot.copilot_chat_short %} in various IDEs, such as {% data variables.product.prodname_vscode %} and JetBrains IDEs. For {% data variables.copilot.copilot_chat_dotcom_short %}, the {% data variables.product.github %} MCP server is automatically configured, enabling {% data variables.copilot.copilot_chat_short %} to perform a limited set of tasks, at your request, such as creating branches or merging pull requests. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/extend-copilot-chat-with-mcp) and [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/use-the-github-mcp-server). - -### Further reading - -* [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot) how-to guides -* [AUTOTITLE](/copilot/how-tos/copilot-on-github/chat-with-copilot) how-to guides -* [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/overview) -* [AUTOTITLE](/copilot/tutorials/copilot-cookbook) diff --git a/content/copilot/concepts/completions/code-referencing.md b/content/copilot/concepts/completions/code-referencing.md deleted file mode 100644 index b611f03758de..000000000000 --- a/content/copilot/concepts/completions/code-referencing.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: GitHub Copilot code referencing -shortTitle: Code referencing -allowTitleToDifferFromFilename: true -intro: '{% data variables.product.prodname_copilot %} checks suggestions for matches with publicly available code. Any matches are discarded or suggested with a code reference.' -defaultTool: vscode -versions: - feature: copilot -contentType: concepts -category: - - Learn about Copilot ---- - -{% jetbrains %} - -## About {% data variables.product.prodname_copilot_short %} code referencing in JetBrains IDEs - -{% data reusables.copilot.about-code-referencing %} - -### Code referencing for {% data variables.product.prodname_copilot_short %} inline suggestions - -{% data reusables.copilot.code-referencing-note %} - -### Code referencing for {% data variables.copilot.copilot_chat_short %} - -{% data reusables.copilot.code-referencing-in-chat %} - -{% endjetbrains %} - -{% vscode %} - -## About {% data variables.product.prodname_copilot_short %} code referencing in {% data variables.product.prodname_vscode %} - -{% data reusables.copilot.about-code-referencing %} - -### Code referencing for {% data variables.product.prodname_copilot_short %} inline suggestions - -{% data reusables.copilot.code-referencing-note %} - -### Code referencing for {% data variables.copilot.copilot_chat_short %} - -{% data reusables.copilot.code-referencing-in-chat %} - -{% endvscode %} - -{% webui %} - -## About {% data variables.product.prodname_copilot_short %} code referencing on {% data variables.product.prodname_dotcom_the_website %} - -### Code referencing for {% data variables.copilot.copilot_chat_short %} - -If you, or your organization, have allowed suggestions that match public code, then whenever a response from {% data variables.copilot.copilot_chat_short %} includes matching code, details of the matches will be included in the response. - -> [!NOTE] -> Typically, matches to public code occur infrequently, so you should not expect to see code references in many {% data variables.copilot.copilot_chat_short %} responses. - -### Code referencing for {% data variables.copilot.copilot_cloud_agent %} - -When {% data variables.product.prodname_copilot_short %} generates code that matches code in a public {% data variables.product.github %} repository, this is indicated in the agent session logs with a link to display details of the matched code. For more information, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents). - -{% endwebui %} - -{% visualstudio %} - -## About {% data variables.product.prodname_copilot_short %} code referencing in {% data variables.product.prodname_vs %} - -{% data reusables.copilot.about-code-referencing %} - -### Code referencing for {% data variables.product.prodname_copilot_short %} inline suggestions - -{% data reusables.copilot.code-referencing-note %} - -### Code referencing for {% data variables.copilot.copilot_chat_short %} - -When {% data variables.copilot.copilot_chat_short %} provides a response that includes code that matches code in a public {% data variables.product.github %} repository, this is indicated below the suggested code, with a link to display details of the matched code in the output log. - -{% endvisualstudio %} - -## How code referencing finds matching code - -{% data variables.product.prodname_copilot_short %} code referencing compares potential code suggestions and the surrounding code of about 150 characters against an index of all public repositories on {% data variables.product.prodname_dotcom_the_website %}. - -Code in private {% data variables.product.prodname_dotcom %} repositories, or code outside of {% data variables.product.prodname_dotcom %}, is not included in the search process. - -## Limitations - -The search index is refreshed every few months. As a result, newly committed code, and code from public repositories deleted before the index was created, may not be included in the search. For the same reason, the search may return matches to code that has been deleted or moved since the index was created. - -References to matching code are currently available in JetBrains IDEs, {% data variables.product.prodname_vs %}, {% data variables.product.prodname_vscode %}, {% data variables.copilot.copilot_cloud_agent %}, and on the {% data variables.product.github %} website. - -## Further reading - -* [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/find-matching-code) -* [AUTOTITLE](/copilot/how-tos/manage-your-account/manage-policies) -* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies) diff --git a/content/copilot/concepts/completions/code-suggestions.md b/content/copilot/concepts/completions/code-suggestions.md deleted file mode 100644 index 35e821282b48..000000000000 --- a/content/copilot/concepts/completions/code-suggestions.md +++ /dev/null @@ -1,180 +0,0 @@ ---- -title: GitHub Copilot code suggestions in your IDE -shortTitle: Code suggestions -allowTitleToDifferFromFilename: true -intro: 'Learn about {% data variables.product.prodname_copilot_short %} code suggestions in different IDEs.' -versions: - feature: copilot -defaultTool: vscode -contentType: concepts -category: - - Learn about Copilot ---- - -{% vscode %} - -## About code suggestions in {% data variables.product.prodname_vscode %} - -{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vscode %} provides two kinds of code suggestions: - -* **{% data variables.copilot.next_edit_suggestions_caps %}** - - Based on the edits you are making, {% data variables.product.prodname_copilot_short %} both predicts the location of the next edit you'll want to make and what that edit should be. To enable {% data variables.copilot.next_edit_suggestions %}, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/set-up-copilot/configure-in-ide#enabling-next-edit-suggestions). - -* **Ghost text suggestions** - - {% data variables.product.prodname_copilot_short %} offers coding suggestions as you type. Start typing in the editor, and Copilot provides dimmed ghost text suggestions at your current cursor location. You can also describe something you want to do using natural language within a comment, and {% data variables.product.prodname_copilot_short %} will suggest the code to accomplish your goal. - -{% data reusables.copilot.supported-languages %} - -{% endvscode %} - -{% jetbrains %} - -## About code suggestions in JetBrains IDEs - -{% data variables.product.prodname_copilot_short %} offers inline suggestions as you type. - -{% data reusables.copilot.supported-languages %} - -{% endjetbrains %} - -{% visualstudio %} - -## About code suggestions in {% data variables.product.prodname_vs %} - -{% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_vs %} provides two kinds of code suggestions: - -* **Ghost text suggestions** - - {% data variables.product.prodname_copilot_short %} offers coding suggestions as you type. - -* **{% data variables.copilot.next_edit_suggestions_caps %} ({% data variables.release-phases.public_preview %})** - - Based on the edits you are making, {% data variables.product.prodname_copilot_short %} will predict the location of the next edit you are likely to make and suggest a completion for it. Suggestions may span a single symbol, an entire line, or multiple lines, depending on the scope of the potential change. To enable {% data variables.copilot.next_edit_suggestions %}, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/set-up-copilot/configure-in-ide#enabling-next-edit-suggestions). - -{% data reusables.copilot.supported-languages %} - -{% endvisualstudio %} - -{% vimneovim %} - -## About code suggestions in Vim/Neovim - -{% data variables.product.prodname_copilot %} provides inline suggestions as you type in Vim/Neovim. - -{% endvimneovim %} - -{% azure_data_studio %} - -## About code suggestions in Azure Data Studio - -{% data variables.product.prodname_copilot %} provides you with inline suggestions as you create SQL databases in Azure Data Studio. - -{% endazure_data_studio %} - -{% xcode %} - -## About code suggestions in Xcode - -{% data variables.product.prodname_copilot %} in Xcode provides two kinds of code suggestions: - -* **Ghost text suggestions** - * {% data variables.product.prodname_copilot_short %} offers coding suggestions as you type. You can also describe something you want to do using natural language within a comment, and {% data variables.product.prodname_copilot_short %} will suggest the code to accomplish your goal. -* **{% data variables.copilot.next_edit_suggestions_caps %} ({% data variables.release-phases.public_preview %})** - * Based on the edits you are making, {% data variables.product.prodname_copilot_short %} will predict the location of the next edit you are likely to make and suggest a completion for it. Suggestions may span an entire line, or multiple lines, depending on the scope of the potential change. {% data variables.copilot.next_edit_suggestions_caps %} are enabled by default. To disable, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/set-up-copilot/configure-in-ide?tool=xcode#enabling-next-edit-suggestions-2). - -{% endxcode %} - -{% eclipse %} - -## About code suggestions in Eclipse - -{% data variables.product.prodname_copilot %} in Eclipse provides two kinds of code suggestions: - -* **Ghost text suggestions** - * {% data variables.product.prodname_copilot_short %} offers coding suggestions as you type. You can also describe something you want to do using natural language within a comment, and {% data variables.product.prodname_copilot_short %} will suggest the code to accomplish your goal. -* **{% data variables.copilot.next_edit_suggestions_caps %} ({% data variables.release-phases.public_preview %})** - * Based on the edits you are making, {% data variables.product.prodname_copilot_short %} will predict the location of the next edit you are likely to make and suggest a completion for it. Suggestions may span a single symbol, an entire line, or multiple lines, depending on the scope of the potential change. To enable {% data variables.copilot.next_edit_suggestions %}, see [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/set-up-copilot/configure-in-ide?tool=eclipse#enabling-next-edit-suggestions-2). - -{% data reusables.copilot.supported-languages %} - -{% endeclipse %} - -## Code suggestions that match public code - -{% data variables.product.prodname_copilot %} checks each suggestion for matches with publicly available code. Matches may be discarded or suggested with a code reference, based on the setting of the "Suggestions matching public code" policy for your account or organization. See [AUTOTITLE](/copilot/concepts/completions/code-referencing). - -{% vscode %} - -## Changing the model used for inline suggestions - -{% data reusables.copilot.code-completion-switch-prereqs-vscode %} - -Changing the model only affects {% data variables.product.prodname_copilot_short %} ghost text suggestions. It does not affect {% data variables.product.prodname_copilot_short %} next edit suggestions. - -{% data reusables.copilot.code-completion-switch-model-affects %} - -{% endvscode %} - -{% visualstudio %} - -## Changing the model used for inline suggestions - -{% data reusables.copilot.code-completion-switch-prereqs-vs %} - -{% data reusables.copilot.code-completion-switch-model-affects %} - -{% endvisualstudio %} - -{% jetbrains %} - -## Changing the model used for inline suggestions - -{% data reusables.copilot.code-completion-switch-prereqs-jetbrains %} - -{% data reusables.copilot.code-completion-switch-model-affects %} - -{% endjetbrains %} - -## Programming languages included in the default model - -The following programming languages and technologies are included in the training data for the default LLM used for {% data variables.product.prodname_copilot_short %} inline suggestions: - - * C - * C# - * C++ - * Clojure - * CSS - * Dart - * Dockerfile - * Elixir - * Emacs Lisp - * Go - * Haskell - * HTML - * Java - * JavaScript - * Julia - * Jupyter Notebook - * Kotlin - * Lua - * MATLAB - * Objective-C - * Perl - * PHP - * PowerShell - * Python - * R - * Ruby - * Rust - * Scala - * Shell - * Swift - * TeX - * TypeScript - * Vue - -## Next steps - -* [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions) diff --git a/content/copilot/concepts/completions/index.md b/content/copilot/concepts/completions/index.md deleted file mode 100644 index 43a60e30aed4..000000000000 --- a/content/copilot/concepts/completions/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Completions for GitHub Copilot -shortTitle: Completions -intro: 'Learn how {% data variables.product.prodname_copilot_short %} can provide inline suggestions.' -versions: - feature: copilot -children: - - /code-suggestions - - /code-referencing -contentType: concepts -redirect_from: - - /copilot/concepts/completions/text-completion ---- diff --git a/content/copilot/concepts/context/mcp.md b/content/copilot/concepts/context/mcp.md index 0e19986a974a..eddaf6cf48ff 100644 --- a/content/copilot/concepts/context/mcp.md +++ b/content/copilot/concepts/context/mcp.md @@ -55,6 +55,7 @@ MCP is supported across the following clients: * **IDEs**: There is broad support for local MCP servers in clients such as {% data variables.product.prodname_vscode %}, JetBrains IDEs, Xcode, and others. Support for remote MCP servers is growing, with editors like {% data variables.product.prodname_vscode %}, {% data variables.product.prodname_vs %}, JetBrains IDEs, Xcode, Eclipse, Cursor, and Windsurf providing this functionality with OAuth or PAT. To find out if your preferred editor supports remote MCP servers, check the documentation for your specific editor. * **{% data variables.copilot.copilot_cli_short %}**: {% data variables.copilot.copilot_cli %} supports both local and remote MCP servers. The {% data variables.product.github %} MCP server is built in and available without additional configuration. * **{% data variables.copilot.github_copilot_app %}**: The {% data variables.copilot.github_copilot_app %} supports MCP servers configured in your repository or {% data variables.copilot.copilot_cli_short %} and lets you add additional MCP servers in app settings. +* **Chat on {% data variables.product.prodname_dotcom_the_website %}**: Chat is preconfigured with tools for tasks such as creating branches, updating files, and semantic code search. See [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). * **{% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_code-review_short %}**: {% data variables.product.prodname_dotcom_the_website %} supports MCP servers configured at the repository level. The configuration applies to both {% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_code-review_short %}. The {% data variables.product.github %} MCP server and Playwright MCP server are configured by default. ## About the {% data variables.product.github %} MCP server diff --git a/content/copilot/concepts/context/repository-indexing.md b/content/copilot/concepts/context/repository-indexing.md index fea5beddbff5..027fcecfae46 100644 --- a/content/copilot/concepts/context/repository-indexing.md +++ b/content/copilot/concepts/context/repository-indexing.md @@ -34,7 +34,7 @@ For more information on how to ask questions, see [AUTOTITLE](/copilot/how-tos/c {% data variables.copilot.copilot_cloud_agent %} uses semantic code search to find relevant code based on meaning, rather than relying solely on exact text matches with tools like `grep`. When the agent doesn't know the precise names or patterns to search for, semantic code search helps it locate the right code faster. No configuration is required—the agent automatically uses semantic code search when appropriate. -For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## About index creation and use diff --git a/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md b/content/copilot/concepts/copilot-surfaces/copilot-cli.md similarity index 99% rename from content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md rename to content/copilot/concepts/copilot-surfaces/copilot-cli.md index e1d4e7612adc..3c6b91b78724 100644 --- a/content/copilot/concepts/agents/copilot-cli/about-copilot-cli.md +++ b/content/copilot/concepts/copilot-surfaces/copilot-cli.md @@ -1,6 +1,6 @@ --- -title: About GitHub Copilot CLI -shortTitle: About Copilot CLI +title: GitHub Copilot CLI +shortTitle: Copilot CLI allowTitleToDifferFromFilename: true intro: 'Find out about using {% data variables.product.prodname_copilot_short %} from the command line.' product: '{% data reusables.gated-features.copilot-cli %}' @@ -12,6 +12,8 @@ category: - Learn about Copilot CLI # Copilot CLI bespoke page redirect_from: - /copilot/concepts/agents/about-copilot-cli + - /copilot/concepts/agents/copilot-cli/about-copilot-cli + - /copilot/concepts/copilot-surfaces/about-copilot-cli docsTeamMetrics: - copilot-cli --- diff --git a/content/copilot/concepts/copilot-surfaces/copilot-in-ides.md b/content/copilot/concepts/copilot-surfaces/copilot-in-ides.md new file mode 100644 index 000000000000..7347d7c69608 --- /dev/null +++ b/content/copilot/concepts/copilot-surfaces/copilot-in-ides.md @@ -0,0 +1,109 @@ +--- +title: GitHub Copilot in IDEs +shortTitle: Copilot in IDEs +intro: 'Get contextual AI assistance from {% data variables.product.prodname_copilot %} throughout your IDE workflow, from exploring an approach to writing, reviewing, and improving code.' +versions: + feature: copilot +defaultTool: vscode +contentType: concepts +category: + - Learn about Copilot +redirect_from: + - /copilot/concepts/completions/code-referencing + - /copilot/concepts/completions/code-suggestions + - /copilot/concepts/agents/copilot-in-jetbrains +--- + +{% data variables.product.prodname_copilot %} integrates with supported IDEs to help you throughout the development process. {% data variables.product.prodname_copilot_short %} can explain concepts, complete code, propose edits, and validate files with agent mode. + +The available features and entry points vary by IDE. For a detailed comparison, see [AUTOTITLE](/copilot/reference/copilot-feature-matrix). + +## How {% data variables.product.prodname_copilot_short %} helps in your IDE + +You can work with {% data variables.product.prodname_copilot_short %} in three main ways: + +* **Code suggestions** help you write and edit code without leaving the editor. +* **Chat** lets you ask questions, explain or refactor code, generate tests, and explore possible solutions. +* **Agentic experiences** can plan and complete multi-step tasks by reading files, editing code, and running commands in your local development environment. + +These experiences complement each other. For example, you might use chat to understand an unfamiliar codebase, ask an agent to implement a change across several files, and use inline suggestions to refine the result. + +## Code suggestions + +{% data variables.product.prodname_copilot_short %} can suggest code directly in the editor as you work. Depending on your IDE, these suggestions can include inline suggestions and {% data variables.copilot.next_edit_suggestions %}. + +### Inline suggestions + +Inline suggestions appear as dimmed text at your cursor position. {% data variables.product.prodname_copilot_short %} uses the code around your cursor and other available context to predict what you are likely to write next. + +Suggestions can complete part of a line, an entire line, or a larger block of code. You can also write a natural-language comment describing the code you want, then let {% data variables.product.prodname_copilot_short %} suggest an implementation. + +You remain responsible for reviewing and testing suggested code before using it. + +### {% data variables.copilot.next_edit_suggestions_caps %} + +{% data variables.copilot.next_edit_suggestions_caps %} predict both where you are likely to make your next change and what that change could be. They are based on the edits you are currently making and can help you apply related changes elsewhere in a file. + +For example, after you rename a method or change a data structure, {% data variables.product.prodname_copilot_short %} might suggest updating another location affected by that change. + +Availability and configuration vary by IDE. For instructions on using inline and next edit suggestions, see [AUTOTITLE](/copilot/how-tos/get-code-suggestions/get-ide-code-suggestions). + +{% data reusables.copilot.supported-languages %} + +## Chat and agentic experiences + +{% data variables.copilot.copilot_chat %} provides a conversational interface in your IDE. Because chat can use context from your project, you can ask questions about selected code, open files, or your wider codebase. + +You can use chat to: + +* Explain unfamiliar code. +* Suggest fixes for bugs. +* Refactor or document code. +* Generate tests. +* Compare implementation approaches. +* Answer questions about programming languages and development tools. + +For larger tasks, an agentic experience can break your request into steps and use tools to complete the work. Depending on your IDE and configuration, an agent can inspect your project, edit multiple files, run terminal commands, and respond to errors encountered while working. + +Agentic changes are made in your local development environment. Review the proposed changes and the output of any commands before accepting the result. + +For instructions on using chat and agents, see [AUTOTITLE](/copilot/how-tos/chat-with-copilot/chat-in-ide). + +## Choosing an entry point + +For most IDEs, the **{% data variables.product.prodname_copilot %} extension or plugin** is the primary entry point. It connects {% data variables.product.prodname_copilot_short %} directly to your editor and provides the features supported by that IDE. You can install the appropriate integration by following [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-extension). + +You can also run **{% data variables.copilot.copilot_cli %}** in an IDE's integrated terminal if the terminal environment meets the requirements for {% data variables.copilot.copilot_cli_short %}. Integration between CLI sessions and the IDE varies. + +### Entry points in JetBrains IDEs + +In {% data variables.product.prodname_jetbrains_ides %}, there are three primary entry points for accessing {% data variables.product.prodname_copilot_short %} to choose from: the {% data variables.product.prodname_copilot %} plugin, the JetBrains AI Assistant, or {% data variables.copilot.copilot_cli %} in the integrated terminal. + +| Entry point | Best for | Main capabilities | +| --- | --- | --- | +| **{% data variables.product.prodname_copilot %} plugin** | A complete AI-assisted development workflow | Inline and next edit suggestions, chat, agentic features, inline chat, code review, and commit message generation | +| **{% data variables.product.prodname_copilot_short %} in JetBrains AI Assistant** | Using chat and an agent without installing a separate {% data variables.product.prodname_copilot_short %} plugin | Chat, agentic tasks, and model selection | +| **{% data variables.copilot.copilot_cli_short %}** | Terminal-first development workflows | Agentic assistance and model selection in the integrated terminal | + +The {% data variables.product.prodname_copilot %} plugin also supports +multiple agent harnesses and OpenTelemetry monitoring. Enterprise administrators can use managed settings to control plugin marketplaces, MCP servers, OpenTelemetry configuration, and whether users can bypass permission checks. For more information, see [AUTOTITLE](/copilot/concepts/enterprise/opentelemetry) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/get-started). + +The {% data variables.product.prodname_copilot %} plugin provides the broadest integration with the editor and is the recommended entry point when you want code suggestions and the full set of IDE features. + +{% data variables.product.prodname_copilot_short %} is also available as an agent in JetBrains AI Assistant through the Agent Client Protocol (ACP). For more information about ACP, see the [ACP documentation](https://agentclientprotocol.com/get-started/introduction). For technical details on running {% data variables.copilot.copilot_cli_short %} as an ACP server, see [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server). + +## References to matching public code + +{% data variables.product.prodname_copilot %} checks suggestions for matches with code in public repositories on {% data variables.product.prodname_dotcom_the_website %}. Depending on the policy that applies to your account or organization, matching suggestions can be blocked or shown with information about the matching code. + +For inline suggestions, code referencing compares a potential suggestion and approximately 150 characters of surrounding code with an index of public repositories. Code from private repositories and code hosted outside {% data variables.product.prodname_dotcom %} are not included in the search. + +When you accept an inline suggestion that matches public code, {% data variables.product.prodname_copilot_short %} records details such as the matching file URLs and any detected licenses. Only accepted, unchanged suggestions are checked in this way. + +When a {% data variables.copilot.copilot_chat_short %} response contains code that matches code in a public repository, the response includes a link to information about the match. See [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github#references-to-matching-public-code). + +Typically, matches to public code occur in less than one percent of {% data variables.product.prodname_copilot_short %} suggestions, so you should not expect to see code references for many suggestions. + +The public-code index is refreshed periodically, so it may not include recently added code and may contain references to code that has since moved or been deleted. + +Code references help you review the source and licensing of matching code so you can decide whether to use, attribute, or remove it. For instructions on viewing references, see [AUTOTITLE](/copilot/how-tos/get-code-suggestions/find-matching-code). diff --git a/content/copilot/concepts/copilot-surfaces/copilot-on-github.md b/content/copilot/concepts/copilot-surfaces/copilot-on-github.md new file mode 100644 index 000000000000..d5a7416c5adb --- /dev/null +++ b/content/copilot/concepts/copilot-surfaces/copilot-on-github.md @@ -0,0 +1,154 @@ +--- +title: GitHub Copilot on GitHub.com +allowTitleToDifferFromFilename: true +shortTitle: '{% data variables.product.prodname_copilot_short %} on {% data variables.product.prodname_dotcom_the_website %}' +intro: 'Explore your repositories, plan changes, and delegate coding tasks to {% data variables.product.prodname_copilot %} without leaving {% data variables.product.prodname_dotcom_the_website %}.' +versions: + feature: copilot +redirect_from: + - /copilot/concepts/about-github-copilot-chat + - /copilot/concepts/chat + - /copilot/github-copilot-enterprise/copilot-chat-in-github/about-github-copilot-chat + - /copilot/concepts/agents/cloud-agent/about-cloud-agent + - /copilot/concepts/agents/coding-agent/about-coding-agent + - /copilot/concepts/about-assigning-tasks-to-copilot + - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-tasks/about-assigning-tasks-to-copilot + - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/about-assigning-issues-to-copilot + - /copilot/using-github-copilot/using-copilot-coding-agent-to-work-on-issues/about-assigning-tasks-to-copilot + - /copilot/using-github-copilot/coding-agent/about-assigning-tasks-to-copilot + - /copilot/concepts/about-copilot-coding-agent + - /copilot/concepts/coding-agent/about-copilot-coding-agent + - /copilot/concepts/coding-agent/coding-agent +contentType: concepts +category: + - Learn about Copilot +--- + +{% data variables.product.prodname_copilot %} on {% data variables.product.prodname_dotcom_the_website %} can answer questions about your repositories, plan and make changes, review pull requests, and automate repository tasks. You can ask questions and delegate work from the same prompt box, or use {% data variables.product.prodname_copilot_short %} directly in your issue and pull request workflows. + +To compare where you can use {% data variables.product.prodname_copilot_short %}, see [AUTOTITLE](/copilot/get-started/where-to-use-github-copilot). + +## How {% data variables.product.prodname_copilot_short %} helps on {% data variables.product.prodname_dotcom_the_website %} + +You can work with {% data variables.product.prodname_copilot_short %} in several ways: + +* **Chat** lets you ask questions about your repositories, understand code, and explore possible solutions. +* **Agentic experiences** can research a repository, plan changes, and complete multi-step tasks by reading files, editing code, and running tests in a cloud development environment. +* **Code review** provides feedback on pull requests and suggests fixes. +* **Automations** run repository tasks on a schedule or in response to events, rather than requiring a new prompt each time. + +For example, you might use chat to understand how a repository handles authentication, then ask an agent to plan and add missing tests. Once the changes are in a pull request, you can request a review from {% data variables.product.prodname_copilot_short %}. To maintain test coverage over time, you could set up an automation to check for missing tests each week and propose additions for you to review. + +## Chat and agentic experiences + +On {% data variables.product.prodname_dotcom_the_website %}, you can move from asking questions to delegating work in the same conversation. + +### Asking questions + +Chat can explain unfamiliar code, suggest fixes, generate tests, or compare approaches. Follow-up questions let you refine your request without starting a new conversation. + +Chat is preconfigured with tools for tasks such as creating branches, updating files, and creating or updating issues. It also supports semantic code search. + +### Delegating work + +{% data variables.copilot.copilot_cloud_agent %} can research a repository, plan changes, and implement them in the background. It can edit files and run tests and linters in an ephemeral cloud development environment, rather than your local IDE. See [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides). + +You can start work from the agents panel, a conversation, or an issue or pull request on {% data variables.product.prodname_dotcom_the_website %}. +{% ifversion security-campaigns-assign-to-cca %} +From security campaigns, you can assign code scanning alerts to {% data variables.product.prodname_copilot_short %} for fixes. See [AUTOTITLE](/code-security/how-tos/manage-security-alerts/remediate-alerts-at-scale/fixing-alerts-in-security-campaign#assigning-alerts-to-copilot-cloud-agent). +{% endif %} + +When implementing changes, {% data variables.product.prodname_copilot_short %} handles branch creation, commit messages, and pushing changes. You can review changes and request refinements before creating a pull request, or request a pull request in your initial prompt. You can also continue the work yourself. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate). + +### Session context + +On {% data variables.product.prodname_dotcom_the_website %}, {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_cloud_agent %} can share context. When you start an agent session from a chat, the session incorporates the context of your conversation. While the session runs, you can continue chatting with {% data variables.product.prodname_copilot_short %} about its progress and steer the work. + +{% data variables.copilot.copilot_chat_short %} can also answer questions about pull requests created by {% data variables.product.prodname_copilot_short %} by pulling in the relevant agent session logs. You can ask what changed, what was validated, and why, without leaving the conversation. + +This context passing is scoped to the {% data variables.copilot.copilot_chat_short %} and {% data variables.copilot.copilot_cloud_agent_short %} sessions you are actively working with. It is distinct from {% data variables.copilot.copilot_memory %}, which builds a longer-term, persistent understanding of your repositories and preferences across sessions. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-memory). + +On {% data variables.product.prodname_dotcom_the_website %}, session logs show the work and tools used. Shared sessions and pull requests let teammates with repository access follow the work and review changes. Logs do not replace your own review and testing. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents). + +### Sessions across surfaces + +With remote control enabled, you can monitor and steer a {% data variables.copilot.copilot_cli %} session from {% data variables.product.prodname_dotcom_the_website %}. It continues running on your original machine, which must stay online. See [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-remote-control). + +On {% data variables.product.prodname_dotcom_the_website %}, you can ask about your synced session history across {% data variables.product.prodname_copilot_short %} surfaces. This includes {% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_code-review_short %} sessions, and sessions from {% data variables.copilot.copilot_cli %}, {% data variables.product.prodname_vscode_shortname %}, {% data variables.product.prodname_jetbrains_ides %}, and the {% data variables.copilot.github_copilot_app %}. + +You can only query sessions you started. Syncing must be enabled and permitted by your organization's policies. See [Query past sessions](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents#query-past-sessions). + +## Code review + +On {% data variables.product.prodname_dotcom_the_website %}, {% data variables.copilot.copilot_code-review_short %} reviews pull request changes, identifies potential issues, and suggests fixes. It uses agentic capabilities to gather context from your repository. You can request a review or configure automatic reviews, then review and apply the suggested changes. See [AUTOTITLE](/copilot/concepts/agents/code-review). + +{% data variables.product.prodname_copilot_short %} can also generate a summary of your changes directly in a pull request description or comment. This helps reviewers understand the changes, but is separate from reviewing the code. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/copilot-for-github-tasks/create-a-pr-summary). + +## Automations and agentic workflows + +{% data variables.copilot.copilot_automations_cap %} let you define a task once and have {% data variables.copilot.copilot_cloud_agent %} run it on a schedule or in response to repository events. For example, an automation can triage incoming issues or prepare weekly release notes. You create and manage automations from the **Agents** tab in a repository on {% data variables.product.prodname_dotcom_the_website %}. Automations are available in eligible private and internal repositories. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-automations). + +{% data variables.copilot.github_agentic_workflows %} provide another way to automate tasks in your repositories on {% data variables.product.prodname_dotcom_the_website %}. You define tasks in natural language in Markdown files, and they run as {% data variables.product.prodname_actions %} workflows. These workflows can use {% data variables.product.prodname_copilot_short %} or another supported coding agent. See [AUTOTITLE](/copilot/concepts/agents/about-github-agentic-workflows). + +## Customizations + +On {% data variables.product.prodname_dotcom_the_website %}, custom instructions let you save personal preferences for chat, repository conventions, and organization guidance. {% data variables.copilot.copilot_spaces %} organize shared context for questions. For delegated work, {% data variables.copilot.custom_agents_short %} and agent skills provide task-specific instructions and resources. Model Context Protocol (MCP) servers connect agents to additional tools and data. Hooks can run commands during agent work for validation or logging. For setup guidance, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot). + +## AI models + +{% data reusables.copilot.change-the-ai-model %} + +On {% data variables.product.prodname_dotcom_the_website %}, available models depend on your plan and account policies. See [AUTOTITLE](/copilot/reference/ai-models/supported-models). + +For {% data variables.copilot.copilot_cloud_agent %}, the ability to select a model also depends on how you start the task. See [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model). + +## References to matching public code + +In chat responses and agent sessions on {% data variables.product.prodname_dotcom_the_website %}, {% data variables.product.prodname_copilot_short %} can generate code that matches code in public repositories. Code references help you review the matching code and its licensing information so you can decide whether to use it, provide attribution, or remove it. + +Matches appear in the context where you are reviewing the output: + +* **Chat responses**: If you or your organization allow suggestions matching public code, matching code in a response includes a reference beneath the suggestion. The reference identifies public repositories containing matching code and licensing information, if found. +* **Agent session logs**: When {% data variables.product.prodname_copilot_short %} generates matching code during a delegated task, the session logs include a link to details of the matched code. + +Matches occur infrequently, so most responses do not contain code references. The search covers an index of public repositories on {% data variables.product.prodname_dotcom_the_website %}, not private repositories or code hosted elsewhere. The index is refreshed periodically, so it may omit recently added code or refer to code that has since moved or been deleted. + +For instructions on viewing references, see [AUTOTITLE](/copilot/how-tos/get-code-suggestions/find-matching-code?tool=webui). + +## Access and availability + +Available features depend on your plan and organization policies. For setup guidance, see [AUTOTITLE](/copilot/how-tos/copilot-on-github/set-up-copilot). For usage allowances and costs, see [AUTOTITLE](/copilot/concepts/billing-and-usage). + +Repository owners and administrators can disable {% data variables.copilot.copilot_cloud_agent %} for particular repositories, even when your plan and policies otherwise allow you to use it. See [AUTOTITLE](/copilot/concepts/enterprise/cloud-agent-access). + +## Limitations and compatibility + +Both chat and agentic experiences on {% data variables.product.prodname_dotcom_the_website %} can produce incorrect or suboptimal code, including code that contains security vulnerabilities. Review and test the output before using it in production. See [AUTOTITLE](/copilot/responsible-use/agents). + +For information about built-in security protections, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/risks-and-mitigations). + +### Agentic work + +{% data variables.copilot.copilot_cloud_agent %} has the following workflow limitations: + +* **Repository scope**: {% data variables.product.prodname_copilot_short %} can only make changes in the repository specified when you start a task. It cannot make changes across multiple repositories in one run. +* **Context access**: By default, the {% data variables.product.github %} MCP server only provides access to context in the repository where the agent is working, such as issues and previous pull requests. You can configure broader access through repository MCP settings. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers). +* **Branches and pull requests**: {% data variables.product.prodname_copilot_short %} can only work on one branch at a time and can open one pull request per task. +* **Session duration**: Each {% data variables.copilot.copilot_cloud_agent %} session has a maximum execution time of 59 minutes. This limit cannot be extended or bypassed. If a task exceeds the limit, the session times out and stops. + + Break complex tasks into smaller, focused tasks. You can configure a shorter timeout using the `timeout-minutes` setting in your `copilot-setup-steps.yml` file. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment). + + + +### Repository compatibility + +* **Repository rules**: If a ruleset or branch protection rule is incompatible with {% data variables.copilot.copilot_cloud_agent %}, access to the agent is blocked. For example, a rule that only allows specific commit authors can prevent {% data variables.product.prodname_copilot_short %} from creating or updating pull requests. If the rule is configured using rulesets, repository administrators can add {% data variables.product.prodname_copilot_short %} as a bypass actor to enable access. See [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository#granting-bypass-permissions-for-your-branch-or-tag-ruleset). +* **Repository hosting**: {% data variables.copilot.copilot_cloud_agent %} only works with repositories hosted on {% data variables.product.github %}. It cannot work on repositories stored on other code hosting platforms. + +## Further reading + +* [AUTOTITLE](/copilot/how-tos/copilot-on-github) +* [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent) how-to guides +* [AUTOTITLE](/copilot/tutorials/copilot-cookbook) +* For delegating work from tools such as Microsoft Teams and Slack, see [AUTOTITLE](/copilot/concepts/tools/about-copilot-integrations). +* For organization and enterprise metrics on pull request creation, merges, and time to merge, see [AUTOTITLE](/copilot/concepts/billing-and-usage/copilot-usage-metrics/copilot-metrics). diff --git a/content/copilot/concepts/agents/github-copilot-app.md b/content/copilot/concepts/copilot-surfaces/github-copilot-app.md similarity index 99% rename from content/copilot/concepts/agents/github-copilot-app.md rename to content/copilot/concepts/copilot-surfaces/github-copilot-app.md index cb92f38e0d9e..4bf180d364f7 100644 --- a/content/copilot/concepts/agents/github-copilot-app.md +++ b/content/copilot/concepts/copilot-surfaces/github-copilot-app.md @@ -1,5 +1,5 @@ --- -title: About the GitHub Copilot app +title: GitHub Copilot app shortTitle: GitHub Copilot app intro: 'The {% data variables.copilot.github_copilot_app %} is a desktop application for agent-driven development that brings parallel workstreams, {% data variables.product.github %} integration, and PR lifecycle management into one place.' product: '{% data reusables.gated-features.github-app %}
Download {% data variables.copilot.github_copilot_app %} {% octicon "link-external" height:16 %}' @@ -8,6 +8,7 @@ versions: contentType: concepts redirect_from: - /copilot/concepts/agents/github-app + - /copilot/concepts/agents/github-copilot-app category: - Learn about Copilot --- diff --git a/content/copilot/concepts/copilot-surfaces/index.md b/content/copilot/concepts/copilot-surfaces/index.md new file mode 100644 index 000000000000..c0ff3765c691 --- /dev/null +++ b/content/copilot/concepts/copilot-surfaces/index.md @@ -0,0 +1,16 @@ +--- +title: GitHub Copilot surfaces +shortTitle: Copilot surfaces +intro: Learn about the different places where you can use {% data variables.product.prodname_copilot %}. +versions: + feature: copilot +children: + - /github-copilot-app + - /copilot-cli + - /copilot-on-github + - /copilot-in-ides +contentType: concepts +redirect_from: + - /copilot/concepts/completions + - /copilot/concepts/completions/text-completion +--- diff --git a/content/copilot/concepts/enterprise/cloud-agent-access.md b/content/copilot/concepts/enterprise/cloud-agent-access.md index 5fb88fd8232a..66f9f6ea5e45 100644 --- a/content/copilot/concepts/enterprise/cloud-agent-access.md +++ b/content/copilot/concepts/enterprise/cloud-agent-access.md @@ -25,7 +25,7 @@ category: --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Overview diff --git a/content/copilot/concepts/index.md b/content/copilot/concepts/index.md index b31b4cfe830b..3ae153975230 100644 --- a/content/copilot/concepts/index.md +++ b/content/copilot/concepts/index.md @@ -5,8 +5,7 @@ intro: Learn the core concepts that you'll need to understand {% data variables. versions: feature: copilot children: - - /completions - - /chat + - /copilot-surfaces - /agents - /prompting - /context diff --git a/content/copilot/concepts/security-governance-and-network-settings/about-cloud-and-local-sandboxes.md b/content/copilot/concepts/security-governance-and-network-settings/about-cloud-and-local-sandboxes.md index 66105f92f883..471c73b5aedf 100644 --- a/content/copilot/concepts/security-governance-and-network-settings/about-cloud-and-local-sandboxes.md +++ b/content/copilot/concepts/security-governance-and-network-settings/about-cloud-and-local-sandboxes.md @@ -200,6 +200,6 @@ For more information about how cloud sandbox usage is measured and billed, see [ ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli) * [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/using-local-sandboxing) * [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings) diff --git a/content/copilot/concepts/tools/about-copilot-integrations.md b/content/copilot/concepts/tools/about-copilot-integrations.md index 2e3de95d1d9d..d7e41a54ef5e 100644 --- a/content/copilot/concepts/tools/about-copilot-integrations.md +++ b/content/copilot/concepts/tools/about-copilot-integrations.md @@ -15,7 +15,7 @@ category: {% data variables.copilot.copilot_cloud_agent %} can be integrated with various tools and platforms to enhance its functionality and streamline your development workflow. With integrations, you can work with and trigger {% data variables.copilot.copilot_cloud_agent %} from within your existing tools, providing the cloud agent with the context it needs to assist you effectively. -For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Supported integrations diff --git a/content/copilot/get-started/cli-quickstart.md b/content/copilot/get-started/cli-quickstart.md index 13b78e2b5335..589691beb676 100644 --- a/content/copilot/get-started/cli-quickstart.md +++ b/content/copilot/get-started/cli-quickstart.md @@ -127,7 +127,7 @@ where TOPIC is one of the topics listed in the help output. Find out more about {% data variables.copilot.copilot_cli_short %}: -* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli) * [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/overview) * [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices) * [Get started with {% data variables.copilot.copilot_cli %}: A free hands-on course](https://developer.microsoft.com/blog/get-started-with-github-copilot-cli-a-free-hands-on-course) diff --git a/content/copilot/get-started/quickstart-copilot-app.md b/content/copilot/get-started/quickstart-copilot-app.md index a72c7e9d98e1..b84019c42f62 100644 --- a/content/copilot/get-started/quickstart-copilot-app.md +++ b/content/copilot/get-started/quickstart-copilot-app.md @@ -15,7 +15,7 @@ category: - Author and optimize with Copilot --- -For a conceptual overview of the {% data variables.copilot.github_copilot_app %}, see [AUTOTITLE](/copilot/concepts/agents/github-copilot-app). +For a conceptual overview of the {% data variables.copilot.github_copilot_app %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/github-copilot-app). In this quickstart, you will: diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models.md index 85b428d5d7a4..d46347a39244 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models.md @@ -53,5 +53,5 @@ You can choose whether the models you have added are available to organizations ## Further reading * [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models) in our documentation for organizations. -* [AUTOTITLE](/copilot/concepts/chat) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies) diff --git a/content/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent.md b/content/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent.md index 7c1825bf5ab3..3a28e2e4f788 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent.md @@ -19,7 +19,7 @@ category: --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Enabling {% data variables.copilot.copilot_cloud_agent %} for your members diff --git a/content/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models.md b/content/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models.md index 9bfe6786cd3f..2e65c31f5320 100644 --- a/content/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models.md +++ b/content/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models.md @@ -41,5 +41,5 @@ After you've added your key and selected one or more models, you and your organi ## Further reading * [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models) in our documentation for enterprise accounts. -* [AUTOTITLE](/copilot/concepts/chat) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies) diff --git a/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md b/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md index c81695274eb0..089b697de54a 100644 --- a/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md +++ b/content/copilot/how-tos/copilot-cli/administer-copilot-cli-for-your-enterprise.md @@ -28,7 +28,7 @@ You can control the use of {% data variables.copilot.copilot_cli_short %} by con 1. In the "Clients" section, for {% data variables.copilot.copilot_cli_short %}, select your preferred policy. > [!NOTE] -> Disabling {% data variables.copilot.copilot_cli_short %} does not disable the {% data variables.copilot.github_copilot_app %}. The app is governed by its own policy. For more information, see [AUTOTITLE](/copilot/concepts/agents/github-copilot-app). +> Disabling {% data variables.copilot.copilot_cli_short %} does not disable the {% data variables.copilot.github_copilot_app %}. The app is governed by its own policy. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/github-copilot-app). ## How do other AI controls affect {% data variables.copilot.copilot_cli_short %}? diff --git a/content/copilot/how-tos/copilot-cli/cli-best-practices.md b/content/copilot/how-tos/copilot-cli/cli-best-practices.md index 476a2008a79c..87bd568db746 100644 --- a/content/copilot/how-tos/copilot-cli/cli-best-practices.md +++ b/content/copilot/how-tos/copilot-cli/cli-best-practices.md @@ -114,7 +114,7 @@ You can configure {% data variables.copilot.copilot_cli_short %} to use your own * Cost estimates are hidden when using your own provider. Token usage (input, output, and cache counts) is still displayed. * `/delegate` only works if you are also signed in to {% data variables.product.github %}. It transfers the session to {% data variables.product.github %}'s server-side {% data variables.product.prodname_copilot_short %}, not your provider. -See [Using your own model provider](/copilot/concepts/agents/copilot-cli/about-copilot-cli#using-your-own-model-provider). +See [Using your own model provider](/copilot/concepts/copilot-surfaces/copilot-cli#using-your-own-model-provider). ### Set {% data variables.product.prodname_ai_credit_singular %} session limits @@ -514,7 +514,7 @@ Here is what you will learn: ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli) * [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/overview) * [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference) * [{% data variables.product.prodname_copilot_short %} plans and pricing](https://github.com/features/copilot/plans) diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md b/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md index 419a3b499fe5..d5a0d98ebc36 100644 --- a/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md +++ b/content/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers.md @@ -179,7 +179,7 @@ The same server can also be configured with the bare top-level format: ``` > [!NOTE] -> Project-level MCP servers are loaded only after you confirm folder trust on first launch. They are silently skipped in untrusted directories. For more information on folder trust, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories). +> Project-level MCP servers are loaded only after you confirm folder trust on first launch. They are silently skipped in untrusted directories. For more information on folder trust, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli#trusted-directories). In prompt mode (`copilot -p`), project-level MCP servers are loaded automatically if the current directory is already trusted. If the directory is not trusted, project-level MCP servers are skipped by default. To load them anyway, set the `GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP` environment variable to `true`, since prompt mode cannot show an interactive trust prompt. For more information, see [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference#environment-variables). diff --git a/content/copilot/how-tos/copilot-cli/customize-copilot/use-hooks.md b/content/copilot/how-tos/copilot-cli/customize-copilot/use-hooks.md index a125d6c81637..ca8240d714f6 100644 --- a/content/copilot/how-tos/copilot-cli/customize-copilot/use-hooks.md +++ b/content/copilot/how-tos/copilot-cli/customize-copilot/use-hooks.md @@ -105,6 +105,6 @@ The following examples for macOS and Windows show how to configure hooks that wi ## Further reading * [AUTOTITLE](/copilot/reference/hooks-reference) -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) -* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli) * [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment) diff --git a/content/copilot/how-tos/copilot-cli/index.md b/content/copilot/how-tos/copilot-cli/index.md index faefcbf71903..bde928d00957 100644 --- a/content/copilot/how-tos/copilot-cli/index.md +++ b/content/copilot/how-tos/copilot-cli/index.md @@ -23,7 +23,7 @@ sidebarLink: text: All articles href: /copilot/how-tos/copilot-cli introLinks: - overview: /copilot/concepts/agents/copilot-cli/about-copilot-cli + overview: /copilot/concepts/copilot-surfaces/copilot-cli quickstart: /copilot/get-started/cli-quickstart children: - /cli-best-practices @@ -39,8 +39,8 @@ children: - /automate-copilot-cli/schedule-prompts - /content/copilot/concepts/agents/about-agent-skills - /content/copilot/concepts/agents/about-plugins + - /content/copilot/concepts/copilot-surfaces/copilot-cli - /content/copilot/concepts/agents/dynamic-workflows - - /content/copilot/concepts/agents/copilot-cli/about-copilot-cli - /content/copilot/concepts/agents/copilot-cli/about-custom-agents - /content/copilot/concepts/agents/copilot-cli/about-remote-control - /content/copilot/concepts/agents/copilot-cli/autopilot diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md index 36d59c5b3922..93839b38fb90 100644 --- a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli.md @@ -24,7 +24,7 @@ This article shows you how to set trusted directories, configure access for tool ## Setting trusted directories -Trusted directories control where {% data variables.copilot.copilot_cli_short %} can read, modify, and execute files. Trusting a directory has security implications, see [Security considerations](/copilot/concepts/agents/copilot-cli/about-copilot-cli#security-considerations). +Trusted directories control where {% data variables.copilot.copilot_cli_short %} can read, modify, and execute files. Trusting a directory has security implications, see [Security considerations](/copilot/concepts/copilot-surfaces/copilot-cli#security-considerations). ### Choosing to trust a directory @@ -54,7 +54,7 @@ You can edit the list of permanently trusted directories. Trusted directories ar You can control which tools {% data variables.copilot.copilot_cli_short %} can use, either by responding to approval prompts when {% data variables.product.prodname_copilot_short %} attempts to use a tool, or by specifying permissions via command-line flags. -Be aware that allowing tool access has security implications, see [Security considerations](/copilot/concepts/agents/copilot-cli/about-copilot-cli#security-considerations). +Be aware that allowing tool access has security implications, see [Security considerations](/copilot/concepts/copilot-surfaces/copilot-cli#security-considerations). In this section, you can learn how to: diff --git a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md index 7bdda1833672..cc622a4ee642 100644 --- a/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md +++ b/content/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli.md @@ -23,7 +23,7 @@ docsTeamMetrics: - copilot-cli --- -To find out about {% data variables.copilot.copilot_cli_short %} before you install it, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli). +To find out about {% data variables.copilot.copilot_cli_short %} before you install it, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli). ## Prerequisites diff --git a/content/copilot/how-tos/copilot-cli/use-copilot-cli/overview.md b/content/copilot/how-tos/copilot-cli/use-copilot-cli/overview.md index dba1facc216e..79e14de11c30 100644 --- a/content/copilot/how-tos/copilot-cli/use-copilot-cli/overview.md +++ b/content/copilot/how-tos/copilot-cli/use-copilot-cli/overview.md @@ -16,7 +16,7 @@ docsTeamMetrics: - copilot-cli --- -The command-line interface (CLI) for {% data variables.product.prodname_copilot %} allows you to use {% data variables.product.prodname_copilot_short %} directly from your terminal. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli). +The command-line interface (CLI) for {% data variables.product.prodname_copilot %} allows you to use {% data variables.product.prodname_copilot_short %} directly from your terminal. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli). ## Prerequisite @@ -30,7 +30,7 @@ Install {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot {% data variables.product.prodname_copilot_short %} will ask you to confirm that you trust the files in this folder. > [!IMPORTANT] - > During this {% data variables.copilot.copilot_cli %} session, {% data variables.product.prodname_copilot_short %} may attempt to read, modify, and execute files in and below this folder. You should only proceed if you trust the files in this location. For more information about trusted directories, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories). + > During this {% data variables.copilot.copilot_cli %} session, {% data variables.product.prodname_copilot_short %} may attempt to read, modify, and execute files in and below this folder. You should only proceed if you trust the files in this location. For more information about trusted directories, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli#trusted-directories). 1. Choose one of the options: @@ -53,7 +53,7 @@ Install {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot As an alternative to typing, you can speak your prompt. See [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli/voice-input). - For some examples of prompts, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli). + For some examples of prompts, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli). 1. When {% data variables.product.prodname_copilot_short %} wants to use a tool that could modify or execute files—{% data reusables.cli.tools-needing-approval %}—it will ask you to approve the use of the tool. diff --git a/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/change-the-chat-model.md b/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/change-the-chat-model.md index 3d2f27d0c799..1b2caa17bc5f 100644 --- a/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/change-the-chat-model.md +++ b/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/change-the-chat-model.md @@ -120,7 +120,7 @@ For reasoning models that support configurable thinking effort, you can control {% data reusables.copilot.auto-model-option %} > [!TIP] -> Model selection is also available when using {% data variables.product.prodname_copilot_short %} through JetBrains AI Assistant. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-in-jetbrains). +> Model selection is also available when using {% data variables.product.prodname_copilot_short %} through JetBrains AI Assistant. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides). {% endjetbrains %} diff --git a/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide.md b/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide.md index 039ee48c89d2..c0b142131fe2 100644 --- a/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide.md +++ b/content/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide.md @@ -25,7 +25,7 @@ category: ## Introduction -This guide describes how to use {% data variables.copilot.copilot_chat_short %} and agents to automate coding tasks by breaking them into steps, using tools to read files, edit code, and run commands, and self-correcting when something goes wrong. You can also ask general questions about software development, or specific questions about the code in your project. For more information, see [AUTOTITLE](/copilot/concepts/chat). +This guide describes how to use {% data variables.copilot.copilot_chat_short %} and agents to automate coding tasks by breaking them into steps, using tools to read files, edit code, and run commands, and self-correcting when something goes wrong. You can also ask general questions about software development, or specific questions about the code in your project. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides). To learn how to use {% data variables.product.prodname_copilot_short %} for agent-driven workflows in a desktop app, see [AUTOTITLE](/copilot/get-started/quickstart-copilot-app). @@ -315,13 +315,13 @@ The following agents are available: * **Ask mode**: Get quick answers and assistance without making code changes. * **Plan mode**: Collaborate on planning before implementation—{% data variables.product.prodname_copilot_short %} analyzes your request and builds a structured plan for your review. See [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/use-copilot-agents/use-plan-mode). * **Edit mode**: Make controlled edits across multiple files that you review and accept individually. -* **{% data variables.copilot.copilot_cli_short %}**: Runs {% data variables.product.prodname_copilot_short %} through {% data variables.copilot.copilot_cli_short %}, providing a terminal-first agentic experience with support for multiple isolation modes, live session progress, and tool call visibility. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli). +* **{% data variables.copilot.copilot_cli_short %}**: Runs {% data variables.product.prodname_copilot_short %} through {% data variables.copilot.copilot_cli_short %}, providing a terminal-first agentic experience with support for multiple isolation modes, live session progress, and tool call visibility. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli). * **{% data variables.copilot.custom_agents_caps_short %}**: Use personalized agents tailored to your specific needs. See [AUTOTITLE](/copilot/how-tos/copilot-in-your-ide/use-copilot-agents/use-custom-agents). {% data variables.copilot.copilot_edits_short %} lets you make changes across multiple files directly from a single {% data variables.copilot.copilot_chat_short %} prompt, using edit mode and agent mode. > [!TIP] -> You can also access {% data variables.product.prodname_copilot_short %} from JetBrains AI Assistant without installing the {% data variables.product.prodname_copilot_short %} plugin. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-in-jetbrains). +> You can also access {% data variables.product.prodname_copilot_short %} from JetBrains AI Assistant without installing the {% data variables.product.prodname_copilot_short %} plugin. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides). ### Using edit mode diff --git a/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/change-the-completion-model.md b/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/change-the-completion-model.md index d25f5cf75380..4e2bd8157676 100644 --- a/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/change-the-completion-model.md +++ b/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/change-the-completion-model.md @@ -24,7 +24,7 @@ The following instructions are for {% data variables.product.prodname_vscode_sho {% data reusables.copilot.code-completion-available-models %} -For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions#changing-the-model-used-for-inline-suggestions). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions). ## Changing the AI model for inline suggestions @@ -51,7 +51,7 @@ The following instructions are for {% data variables.product.prodname_vs %}. If {% data reusables.copilot.code-completion-available-models %} -For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions#changing-the-model-used-for-inline-suggestions). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions). ## Changing the AI model for inline suggestions @@ -71,7 +71,7 @@ The following instructions are for JetBrains IDEs. If you are using {% data vari {% data reusables.copilot.code-completion-available-models %} -For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions#changing-the-model-used-for-inline-suggestions). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions). ## Changing the AI model for inline suggestions diff --git a/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/find-matching-code.md b/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/find-matching-code.md index ce00a1991a25..f08d2b764890 100644 --- a/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/find-matching-code.md +++ b/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/find-matching-code.md @@ -42,7 +42,7 @@ This version of this article is for {% data variables.product.prodname_copilot_s ## Introduction -If you allow {% data variables.product.prodname_copilot %} to make suggestions that match publicly available code or use a product that does not support "Block" mode, {% data variables.product.prodname_copilot_short %} will display references to any similar code that is found. See [AUTOTITLE](/copilot/concepts/completions/code-referencing). +If you allow {% data variables.product.prodname_copilot %} to make suggestions that match publicly available code or use a product that does not support "Block" mode, {% data variables.product.prodname_copilot_short %} will display references to any similar code that is found. See [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#references-to-matching-public-code). ### Prerequisites @@ -240,4 +240,4 @@ When {% data variables.product.prodname_copilot_short %} provides a response tha ## Further reading -* [AUTOTITLE](/copilot/concepts/completions/code-referencing) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#references-to-matching-public-code) diff --git a/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions.md b/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions.md index 30e801215c88..baed52bd3e1a 100644 --- a/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions.md +++ b/content/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions.md @@ -42,7 +42,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro The examples in this guide use Java, however other languages will work similarly. -For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions?tool=jetbrains). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions). ## Prerequisites @@ -146,7 +146,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro The examples in this guide use C#, however other languages will work similarly. -For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions?tool=visualstudio). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions). ## Prerequisites @@ -259,7 +259,7 @@ This guide demonstrates how to get coding suggestions from {% data variables.pro The examples in this guide use JavaScript, however other languages will work similarly. -For more information, see [AUTOTITLE](/copilot/concepts/completions/code-suggestions?tool=vscode). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions). ## Prerequisites @@ -614,4 +614,4 @@ An arrow in the gutter indicates an available edit suggestion. Hover over the ar ## Further reading -* [AUTOTITLE](/copilot/concepts/completions/code-suggestions) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions) diff --git a/content/copilot/how-tos/copilot-in-your-ide/set-up-copilot/install-copilot-extension.md b/content/copilot/how-tos/copilot-in-your-ide/set-up-copilot/install-copilot-extension.md index cc4020dda3a6..7d9a0c0ccfed 100644 --- a/content/copilot/how-tos/copilot-in-your-ide/set-up-copilot/install-copilot-extension.md +++ b/content/copilot/how-tos/copilot-in-your-ide/set-up-copilot/install-copilot-extension.md @@ -95,7 +95,7 @@ The following procedure will guide you through installation of the {% data varia ## Other ways to access {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_jetbrains_ides %} -The plugin provides the full {% data variables.product.prodname_copilot_short %} experience, but you can also access {% data variables.product.prodname_copilot_short %} through JetBrains AI Assistant or {% data variables.copilot.copilot_cli_short %} without installing the plugin. For a comparison of what each entry point offers, see [AUTOTITLE](/copilot/concepts/agents/copilot-in-jetbrains). +The plugin provides the full {% data variables.product.prodname_copilot_short %} experience, but you can also access {% data variables.product.prodname_copilot_short %} through JetBrains AI Assistant or {% data variables.copilot.copilot_cli_short %} without installing the plugin. For a comparison of what each entry point offers, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides). {% endjetbrains %} diff --git a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-azure-boards.md b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-azure-boards.md index d2a9d122f749..0296993a9d66 100644 --- a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-azure-boards.md +++ b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-azure-boards.md @@ -62,5 +62,5 @@ If you already have the Azure Boards application installed on {% data variables. ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/concepts/enterprise/cloud-agent-access) diff --git a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-jira.md b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-jira.md index 566bacc2099b..28e4ca012c21 100644 --- a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-jira.md +++ b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-jira.md @@ -199,7 +199,7 @@ To resolve this issue, follow these steps to start a new active SSO session for ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/concepts/enterprise/cloud-agent-access) * [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#example-atlassian) * [Collaborate on work items with AI agents](https://support.atlassian.com/jira-software-cloud/docs/collaborate-on-work-items-with-ai-agents/) in the Atlassian documentation diff --git a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-linear.md b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-linear.md index c4c718e92361..3d4925a78230 100644 --- a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-linear.md +++ b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-linear.md @@ -95,5 +95,5 @@ After you trigger {% data variables.copilot.copilot_cloud_agent %} from a Linear ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/concepts/enterprise/cloud-agent-access) diff --git a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-slack.md b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-slack.md index bdafc789a063..aaa25bd615f0 100644 --- a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-slack.md +++ b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-slack.md @@ -134,4 +134,4 @@ When you do not specify a repository or branch, {% data variables.product.prodna ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) - Learn more about {% data variables.copilot.copilot_cloud_agent %} and how it can support you. +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) - Learn more about {% data variables.copilot.copilot_cloud_agent %} and how it can support you. diff --git a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-teams.md b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-teams.md index 9a10abe04f15..d0ab17d2b445 100644 --- a/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-teams.md +++ b/content/copilot/how-tos/copilot-integrations/integrate-cloud-agent-with-teams.md @@ -128,5 +128,5 @@ You can view and share feedback in our [discussion forum](https://github.com/org ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/concepts/enterprise/cloud-agent-access) diff --git a/content/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/use-hooks.md b/content/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/use-hooks.md index 26b9f16e612d..e285ab4e7db1 100644 --- a/content/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/use-hooks.md +++ b/content/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/use-hooks.md @@ -30,6 +30,6 @@ redirect_from: ## Further reading * [AUTOTITLE](/copilot/reference/hooks-reference) -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) -* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli) * [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment) diff --git a/content/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents.md b/content/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents.md index ba71f5bb1396..4a811415b8b2 100644 --- a/content/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents.md +++ b/content/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents.md @@ -115,7 +115,7 @@ When you start a session from {% data variables.copilot.copilot_chat_short %}, i When a session is complete, or when you are viewing a pull request {% data variables.product.prodname_copilot_short %} created, you can ask what changed, what was validated, and why, and {% data variables.product.prodname_copilot_short %} will answer by drawing on the session logs. You can also start another session directly from {% data variables.copilot.copilot_chat_short %}. -For more information, see [AUTOTITLE](/copilot/concepts/chat) and [AUTOTITLE](/copilot/tutorials/explore-pull-requests). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) and [AUTOTITLE](/copilot/tutorials/explore-pull-requests). ## Further reading diff --git a/content/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate.md b/content/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate.md index 62d87d28f900..0f312499dcdb 100644 --- a/content/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate.md +++ b/content/copilot/how-tos/copilot-on-github/use-copilot-agents/research-plan-iterate.md @@ -66,4 +66,4 @@ After research and planning, make changes on a branch, review the diff, and deci ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) diff --git a/content/copilot/how-tos/github-copilot-app/index.md b/content/copilot/how-tos/github-copilot-app/index.md index cca62ad0351a..a11e6138bb4b 100644 --- a/content/copilot/how-tos/github-copilot-app/index.md +++ b/content/copilot/how-tos/github-copilot-app/index.md @@ -11,7 +11,7 @@ sidebarLink: text: All articles href: /copilot/how-tos/github-copilot-app introLinks: - overview: /copilot/concepts/agents/github-copilot-app + overview: /copilot/concepts/copilot-surfaces/github-copilot-app quickstart: /copilot/get-started/quickstart-copilot-app redirect_from: - /copilot/how-tos/github-app diff --git a/content/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model.md index 1b24bcb5a42d..113be1d4844a 100644 --- a/content/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model.md @@ -14,7 +14,7 @@ redirect_from: --- > [!NOTE] -> For an overview of {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +> For an overview of {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Introduction diff --git a/content/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions.md index fc07bb700f2d..68aaf33651be 100644 --- a/content/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions.md @@ -46,4 +46,4 @@ You can also start sessions automatically, on a schedule or in response to event {% data variables.product.prodname_copilot_short %} will start working on the task in the background. Some entry points open a pull request automatically. In other cases, you can prompt {% data variables.product.prodname_copilot_short %} to open a pull request, or create a pull request when {% data variables.product.prodname_copilot_short %} finishes work, from the session logs. -For more information, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). diff --git a/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github.md index 1be6dcd31f13..a032136053f3 100644 --- a/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-on-github.md @@ -18,7 +18,7 @@ category: You can start {% data variables.copilot.copilot_cloud_agent %} sessions from several places on {% data variables.product.github %}. Once a session is running, you can monitor its progress, steer it with follow-up prompts, and iterate on the resulting pull request—all without leaving the browser. -For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). You can also start partner-built agents from these same entry points using {% data variables.copilot.agent_apps %}. For more information, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/use-agent-apps). @@ -156,7 +156,7 @@ You can delegate review comments to have {% data variables.product.prodname_copi 1. Navigate to the first review comment you want {% data variables.product.prodname_copilot_short %} to implement. * To delegate one comment, click **Fix with {% data variables.product.prodname_copilot_short %}**. * To delegate multiple comments, click **Add to batch**. Continue to add the comments you want {% data variables.product.prodname_copilot_short %} to work on. -1. In the **Manage batch** panel, add any additional instructions, and optionally select a model with the model picker. +1. In the **Manage batch** panel, add any additional instructions, and optionally select a model with the model picker. 1. Choose how you want {% data variables.product.prodname_copilot_short %} to apply the changes: * To commit the changes directly to the branch, click **{% octicon "agent" aria-label="The Agents icon" %} Fix and commit**. * To have {% data variables.product.prodname_copilot_short %} create a new pull request with the changes, click **Fix and open pull request** from the dropdown menu. @@ -197,6 +197,6 @@ Use the feedback buttons on {% data variables.product.prodname_copilot_short %}' ## Further reading -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results) * [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent) diff --git a/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-via-the-api.md b/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-via-the-api.md index fe5ff23625ef..801c605cc097 100644 --- a/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-via-the-api.md +++ b/content/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-via-the-api.md @@ -397,5 +397,5 @@ gh api \ ## Further reading * [AUTOTITLE](/rest/agent-tasks/agent-tasks) -* [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) * [AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions) diff --git a/content/copilot/reference/copilot-allowlist-reference.md b/content/copilot/reference/copilot-allowlist-reference.md index 496085e9b0ed..ab632f20be41 100644 --- a/content/copilot/reference/copilot-allowlist-reference.md +++ b/content/copilot/reference/copilot-allowlist-reference.md @@ -67,7 +67,7 @@ If you use {% data variables.enterprise.data_residency %}, your enterprise and { Replace SUBDOMAIN with your enterprise slug. -1. If you plan to use public code detection, allow access to `https://origin-tracker.githubusercontent.com`. This is required to check generated code against public code hosted on {% data variables.product.prodname_dotcom_the_website %}. For more information, see [AUTOTITLE](/copilot/concepts/completions/code-referencing). +1. If you plan to use public code detection, allow access to `https://origin-tracker.githubusercontent.com`. This is required to check generated code against public code hosted on {% data variables.product.prodname_dotcom_the_website %}. For more information, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#references-to-matching-public-code). All other domains that are required on {% data variables.product.prodname_dotcom_the_website %} are **not** required on {% data variables.enterprise.data_residency_site %}. For example: @@ -440,4 +440,3 @@ The allowlist allows access to the following hosts: * `dl.k8s.io` * `pkgs.k8s.io` - diff --git a/content/copilot/reference/copilot-billing/request-based-billing-legacy/copilot-requests.md b/content/copilot/reference/copilot-billing/request-based-billing-legacy/copilot-requests.md index 1fd70e8e33e0..339aaf930410 100644 --- a/content/copilot/reference/copilot-billing/request-based-billing-legacy/copilot-requests.md +++ b/content/copilot/reference/copilot-billing/request-based-billing-legacy/copilot-requests.md @@ -41,9 +41,9 @@ The following {% data variables.product.prodname_copilot_short %} features can u | Feature | Premium request consumption | SKU Attribution | | ------- | ----------- | ----------- | | [{% data variables.copilot.copilot_chat_short %}](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot) | {% data variables.copilot.copilot_chat_short %} uses **one premium request** per user prompt, multiplied by the model's rate. This includes ask, edit, agent, and plan modes in {% data variables.copilot.copilot_chat_short %} in an IDE. | {% data variables.product.prodname_copilot_short %} premium requests | -| [{% data variables.copilot.copilot_cli_short %}](/copilot/concepts/agents/copilot-cli/about-copilot-cli) | Each prompt to {% data variables.copilot.copilot_cli_short %} uses **one premium request** with the default model. For other models, this is multiplied by the model's rate. | {% data variables.product.prodname_copilot_short %} premium requests | +| [{% data variables.copilot.copilot_cli_short %}](/copilot/concepts/copilot-surfaces/copilot-cli) | Each prompt to {% data variables.copilot.copilot_cli_short %} uses **one premium request** with the default model. For other models, this is multiplied by the model's rate. | {% data variables.product.prodname_copilot_short %} premium requests | | [{% data variables.product.prodname_copilot_short %} code review](/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review) | Each time {% data variables.product.prodname_copilot_short %} reviews a pull request (when assigned as a reviewer) or reviews code in your IDE, **13 premium requests** are consumed. | {% data variables.product.prodname_copilot_short %} premium requests | -| [{% data variables.copilot.copilot_cloud_agent %}](/copilot/concepts/agents/cloud-agent/about-cloud-agent) | {% data variables.copilot.copilot_cloud_agent %} uses **one premium request** per session, multiplied by the model's rate. A session begins when you prompt {% data variables.product.prodname_copilot_short %} to undertake a task. In addition, each real-time steering comment made during an active session uses **one premium request** per session, multiplied by the model's rate. | {% data variables.copilot.copilot_cloud_agent %} premium requests | +| [{% data variables.copilot.copilot_cloud_agent %}](/copilot/concepts/copilot-surfaces/copilot-on-github) | {% data variables.copilot.copilot_cloud_agent %} uses **one premium request** per session, multiplied by the model's rate. A session begins when you prompt {% data variables.product.prodname_copilot_short %} to undertake a task. In addition, each real-time steering comment made during an active session uses **one premium request** per session, multiplied by the model's rate. | {% data variables.copilot.copilot_cloud_agent %} premium requests | | [{% data variables.copilot.copilot_spaces %}](/copilot/concepts/context/spaces) | {% data variables.copilot.copilot_spaces %} uses **one premium request** per user prompt, multiplied by the model's rate. | {% data variables.product.prodname_copilot_short %} premium requests | | [{% data variables.product.prodname_openai_codex %} {% data variables.product.prodname_vscode %} integration](/copilot/concepts/agents/openai-codex) | While in preview, each prompt to {% data variables.product.prodname_openai_codex %} uses **one premium request** multiplied by the model multiplier rates. | {% data variables.product.prodname_copilot_short %} premium requests | | [Third-party coding agents](/free-pro-team@latest/copilot/concepts/agents/about-third-party-coding-agents) | While in preview, each prompt to a third-party coding agent uses **one premium request**, multiplied by the model's rate. | {% data variables.product.prodname_copilot_short %} premium requests | diff --git a/content/copilot/reference/copilot-billing/request-based-billing-legacy/github-copilot-premium-requests.md b/content/copilot/reference/copilot-billing/request-based-billing-legacy/github-copilot-premium-requests.md index e24ff8ae592c..cd7fd05dc469 100644 --- a/content/copilot/reference/copilot-billing/request-based-billing-legacy/github-copilot-premium-requests.md +++ b/content/copilot/reference/copilot-billing/request-based-billing-legacy/github-copilot-premium-requests.md @@ -72,7 +72,7 @@ If you run out of free minutes or premium requests, and you have _not_ set up bi {% data variables.copilot.copilot_cloud_agent %} uses a dedicated {% data variables.copilot.copilot_cloud_agent %} premium request SKU. This SKU still pulls from your monthly allowance of premium requests, but allows for more granular budget control and monitoring. -For more information about {% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_custom_agents %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent) and [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents). +For more information about {% data variables.copilot.copilot_cloud_agent %} and {% data variables.copilot.copilot_custom_agents %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github) and [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents). ## Using more than your included premium requests diff --git a/content/copilot/reference/enterprise-administrators/policy-conflicts.md b/content/copilot/reference/enterprise-administrators/policy-conflicts.md index 6c8cf243139a..c0f818b150ae 100644 --- a/content/copilot/reference/enterprise-administrators/policy-conflicts.md +++ b/content/copilot/reference/enterprise-administrators/policy-conflicts.md @@ -37,7 +37,7 @@ Feature, model, and privacy settings for users are set according to the **least | :---- | :---- | :---- | | {% data variables.product.prodname_copilot_short %} Metrics API | Most restrictive organization | {% ifversion ghec %}[AUTOTITLE](/rest/copilot/copilot-usage-metrics){% else %}Not applicable{% endif %} | | Semantic indexing for non-{% data variables.product.github %} repositories | Most restrictive organization (only available when all organizations explicitly set **Enabled**; **Unconfigured** behaves as disabled) | [AUTOTITLE](/copilot/concepts/context/repository-indexing) | -| Suggestions matching public code (privacy policy) | Most restrictive organization | [AUTOTITLE](/copilot/concepts/completions/code-suggestions) | +| Suggestions matching public code (privacy policy) | Most restrictive organization | [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#code-suggestions) | | Allow members without a {% data variables.product.prodname_copilot_short %} license to use {% data variables.copilot.copilot_code-review_short %} in {% data variables.product.prodname_dotcom_the_website %} | Most restrictive organization | [AUTOTITLE](/copilot/responsible-use/agents) | | {% data variables.product.prodname_copilot_short %} can search the web | Least restrictive organization | [AUTOTITLE](/copilot/responsible-use/chat) | | {% data variables.copilot.copilot_mobile_short %} | Least restrictive organization | [AUTOTITLE](/copilot/responsible-use/chat) | @@ -49,7 +49,7 @@ Feature, model, and privacy settings for users are set according to the **least | {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} | Least restrictive organization | [AUTOTITLE](/copilot/responsible-use/chat) | | {% data variables.copilot.copilot_desktop_short %} | Least restrictive organization | [AUTOTITLE](/copilot/responsible-use/chat) | | {% data variables.copilot.copilot_cli_short %} | Least restrictive organization | [AUTOTITLE](/copilot/responsible-use/agents) | -| {% data variables.copilot.github_copilot_app %} | Least restrictive organization | [AUTOTITLE](/copilot/concepts/agents/github-copilot-app) | +| {% data variables.copilot.github_copilot_app %} | Least restrictive organization | [AUTOTITLE](/copilot/concepts/copilot-surfaces/github-copilot-app) | | Editor preview features | Least restrictive organization | [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) | | MCP servers in {% data variables.product.prodname_copilot_short %} | Least restrictive organization | [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers) | | {% data variables.product.prodname_copilot_short %}-generated commit messages | Least restrictive organization | [AUTOTITLE](/copilot/responsible-use/chat) | diff --git a/content/copilot/responsible-use/agents.md b/content/copilot/responsible-use/agents.md index 981c4e3059ea..115117ada7d6 100644 --- a/content/copilot/responsible-use/agents.md +++ b/content/copilot/responsible-use/agents.md @@ -215,7 +215,7 @@ Copilot agentic features have been subject to RAI red teaming to identify and ad * **Permission prompts for file modifications**: Copilot CLI asks for permission before modifying files. You should ensure it is modifying the correct files before granting permission. * **Permission prompts for command execution**: Copilot CLI asks for permission before executing commands that may be dangerous. You should review these commands carefully before giving permission to run. * **Configurable permissions**: You can grant Copilot CLI specific permissions, or all permissions, by using the various command line options: for example, `--allow-tool=[TOOLS...]`, `--allow-all-tools`, `--allow-all` (or its slash command equivalent `/allow-all` for use in an interactive session). For more information, see [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference#command-line-options). Typically, when you use Copilot CLI in autopilot mode, you will grant it full permissions to allow it to complete a task autonomously, without requiring you to approve activity as it works on the task. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/autopilot). -* **Security considerations**: For more information about security practices while using Copilot CLI, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli#security-considerations). +* **Security considerations**: For more information about security practices while using Copilot CLI, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli#security-considerations). ### Computer use in {% data variables.copilot.copilot_cli %} and {% data variables.copilot.github_copilot_app %} @@ -309,8 +309,8 @@ For additional guidance on the responsible use of Copilot agentic features, we r * [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-the-firewall) * [AUTOTITLE](/copilot/get-started/sdk-quickstart) * [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers) -* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli) -* [AUTOTITLE](/copilot/concepts/agents/github-copilot-app) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-cli) +* [AUTOTITLE](/copilot/concepts/copilot-surfaces/github-copilot-app) * [AUTOTITLE](/copilot/concepts/agents/computer-use) * [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot) * [Copilot Trust Center](https://copilot.github.trust.page/) diff --git a/content/copilot/tutorials/cloud-agent/get-the-best-results.md b/content/copilot/tutorials/cloud-agent/get-the-best-results.md index 4df27b75c7f5..ca50fb91f53a 100644 --- a/content/copilot/tutorials/cloud-agent/get-the-best-results.md +++ b/content/copilot/tutorials/cloud-agent/get-the-best-results.md @@ -22,7 +22,7 @@ category: --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Making sure your issues are well-scoped diff --git a/content/copilot/tutorials/cloud-agent/improve-a-project.md b/content/copilot/tutorials/cloud-agent/improve-a-project.md index af676185e001..64aab8033232 100644 --- a/content/copilot/tutorials/cloud-agent/improve-a-project.md +++ b/content/copilot/tutorials/cloud-agent/improve-a-project.md @@ -16,7 +16,7 @@ redirect_from: --- > [!NOTE] -> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +> For an introduction to {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). ## Introduction diff --git a/content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md b/content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md index d310cdda54f6..4a8c59e43c17 100644 --- a/content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md +++ b/content/copilot/tutorials/cloud-agent/pilot-cloud-agent.md @@ -30,7 +30,7 @@ category: Before enabling {% data variables.copilot.copilot_cloud_agent %} for members, understand how {% data variables.copilot.copilot_cloud_agent %} will fit into your organization. This will help you evaluate whether {% data variables.copilot.copilot_cloud_agent %} is suitable for your needs and plan communications and training sessions for developers. -1. Learn about {% data variables.copilot.copilot_cloud_agent %}, including the costs and how it differs from other AI tools your developers may be used to. See [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent). +1. Learn about {% data variables.copilot.copilot_cloud_agent %}, including the costs and how it differs from other AI tools your developers may be used to. See [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github). 1. Learn about the tasks that {% data variables.copilot.copilot_cloud_agent %} is best suited for. These are generally well-defined and scoped issues, such as increasing test coverage, fixing bugs or flaky tests, or updating config files or documentation. See [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results). 1. Consider how {% data variables.copilot.copilot_cloud_agent %} fits alongside other tools in your organization's workflows. For an example scenario that walks through how to use {% data variables.copilot.copilot_cloud_agent %} alongside other AI features on {% data variables.product.github %}, see [AUTOTITLE](/copilot/tutorials/roll-out-at-scale/enable-developers/integrate-ai-agents). diff --git a/content/copilot/tutorials/review-ai-generated-code.md b/content/copilot/tutorials/review-ai-generated-code.md index f64199873880..94ddba759559 100644 --- a/content/copilot/tutorials/review-ai-generated-code.md +++ b/content/copilot/tutorials/review-ai-generated-code.md @@ -70,7 +70,7 @@ Be vigilant with new packages and libraries. * Review licensing. Avoid introducing code or dependencies that are incompatible with your project’s license (for example, AGPL-3.0 in a MIT licensed project, or dependencies with no declared license). * Watch out for hallucinated or suspicious packages (such as packages that don't actually exist), or slopsquatting (a theoretical attack on LLMs using fake or malicious packages). * [AUTOTITLE](/copilot/tutorials/copilot-cookbook/communicate-effectively/creating-templates) demonstrates how {% data variables.product.prodname_copilot_short %} can assist with dependency setup, however it is good practice to always verify suggested packages yourself. -* Use [AUTOTITLE](/copilot/concepts/completions/code-referencing) to review matches with publicly available code. +* Use [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-in-ides#references-to-matching-public-code) to review matches with publicly available code. ### Example prompts diff --git a/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md b/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md index 2b95c0c662e1..e92ea6c7ee98 100644 --- a/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md +++ b/content/copilot/tutorials/roll-out-at-scale/drive-downstream-impact/increase-test-coverage.md @@ -135,7 +135,7 @@ Developers **should not**: * [{% data variables.copilot.copilot_chat_dotcom_short %}](/copilot/how-tos/copilot-on-github/chat-with-copilot/chat-in-github) * [{% data variables.product.prodname_copilot_short %} inline suggestions](/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/get-ide-code-suggestions) * [{% data variables.copilot.copilot_chat_short %} in the IDE](/copilot/how-tos/copilot-in-your-ide/chat-with-copilot/chat-in-ide) -* [{% data variables.copilot.copilot_cloud_agent %}](/copilot/concepts/agents/cloud-agent/about-cloud-agent) +* [{% data variables.copilot.copilot_cloud_agent %}](/copilot/concepts/copilot-surfaces/copilot-on-github) ## Metrics to watch diff --git a/content/rest/activity/notifications.md b/content/rest/activity/notifications.md index edc1e22f92a4..d13222f79874 100644 --- a/content/rest/activity/notifications.md +++ b/content/rest/activity/notifications.md @@ -48,6 +48,9 @@ There are a few potential `reason`s for receiving a notification. Reason Name | Description ------------|------------ +| {% ifversion fpt or ghec %} | +`agent_session_finished` | A {% data variables.copilot.copilot_cloud_agent %} session finished. +| {% endif %} | `approval_requested` | You were requested to review and approve a deployment. For more information, see [AUTOTITLE](/actions/how-tos/deploy/configure-and-manage-deployments/review-deployments). `assign` | You were assigned to the issue. `author` | You created the thread. diff --git a/data/llms-txt/config-default.yml b/data/llms-txt/config-default.yml index 798c9de65ff0..f84090e24a98 100644 --- a/data/llms-txt/config-default.yml +++ b/data/llms-txt/config-default.yml @@ -23,7 +23,7 @@ pinned_pages: - copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/extend-copilot-chat-with-mcp - copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/use-the-github-mcp-server - copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/set-up-the-github-mcp-server - - copilot/concepts/agents/cloud-agent/about-cloud-agent + - copilot/concepts/copilot-surfaces/copilot-on-github - copilot/how-tos/copilot-in-your-ide/use-copilot-agents/use-custom-agents - github-cli/github-cli - github-cli/github-cli/quickstart diff --git a/data/llms-txt/docs.md b/data/llms-txt/docs.md index 1a9579683407..5e2d59d0225a 100644 --- a/data/llms-txt/docs.md +++ b/data/llms-txt/docs.md @@ -19,7 +19,7 @@ To retrieve full article content, page lists, or search results programmatically * [Extend Copilot Chat with MCP](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp): Connect MCP servers to Copilot Chat to share context from other applications. * [Use the GitHub MCP Server](https://docs.github.com/en/copilot/how-tos/copilot-in-your-ide/copilot-for-common-tasks/use-the-github-mcp-server): Learn how to use the GitHub Model Context Protocol (MCP) server to interact with repositories, issues, pull requests, and other GitHub features, directly from Copilot Chat in your IDE. * [Set up the GitHub MCP Server](https://docs.github.com/en/copilot/how-tos/provide-context/use-mcp-in-your-ide/set-up-the-github-mcp-server): Learn how to configure the GitHub Model Context Protocol (MCP) server. -* [About cloud agent](https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent): Copilot can research a repository, create an implementation plan, and make code changes on a branch. You can review the diff, iterate, and create a pull request when you're ready. +* [Copilot on GitHub.com](https://docs.github.com/en/copilot/concepts/copilot-surfaces/copilot-on-github): Explore your repositories, plan changes, and delegate coding tasks to GitHub Copilot without leaving GitHub.com. * [Create custom agents in your IDE](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents-in-your-ide): You can create specialized agents with tailored expertise for specific development tasks. * [GitHub CLI](https://docs.github.com/en/github-cli/github-cli): GitHub CLI is an open source tool for using GitHub from your computer's command line. When you're working from the command line, you can use the GitHub CLI to save time and avoid switching context. * [Quickstart](https://docs.github.com/en/github-cli/github-cli/quickstart): Start using GitHub CLI to work with GitHub in the command line. diff --git a/data/reusables/repositories/rulesets-bypass-step.md b/data/reusables/repositories/rulesets-bypass-step.md index 6a2804c462f8..8b5f082a7906 100644 --- a/data/reusables/repositories/rulesets-bypass-step.md +++ b/data/reusables/repositories/rulesets-bypass-step.md @@ -10,7 +10,7 @@ You can grant certain roles, teams, or apps bypass permissions {% ifversion push * {% data variables.product.prodname_github_apps %} * {% data variables.product.prodname_dependabot %}. For more information about {% data variables.product.prodname_dependabot %}, see [AUTOTITLE](/code-security/tutorials/secure-your-dependencies/dependabot-quickstart). {%- ifversion ghec %} -* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#limitations-in-copilot-cloud-agents-compatibility-with-other-features). +* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/copilot-surfaces/copilot-on-github#repository-compatibility). {%- endif %} 1. To grant bypass permissions for the ruleset, in the "Bypass list" section, click **{% octicon "plus" aria-hidden="true" aria-label="plus" %} Add bypass**. diff --git a/src/frame/tests/url-encoding.ts b/src/frame/tests/url-encoding.ts index 6927f46ff21c..cbd38abec863 100644 --- a/src/frame/tests/url-encoding.ts +++ b/src/frame/tests/url-encoding.ts @@ -4,14 +4,18 @@ import { get } from '@/tests/helpers/e2etest' describe('URL encoding for version paths', () => { // SharePoint encodes @ as %40: /en/enterprise-cloud@latest becomes /en/enterprise-cloud%40latest. test('handles URL-encoded @ symbol in enterprise-cloud version', async () => { - const encodedUrl = '/en/enterprise-cloud%40latest/copilot/concepts/chat' + // SharePoint encodes @ as %40, so /en/enterprise-cloud@latest becomes /en/enterprise-cloud%40latest + const encodedUrl = + '/en/enterprise-cloud%40latest/copilot/concepts/copilot-surfaces/copilot-on-github' const res = await get(encodedUrl) // Encoded @ may render directly or redirect to the decoded URL, but it must not 404. expect([200, 301, 302]).toContain(res.statusCode) if (res.statusCode === 301 || res.statusCode === 302) { - expect(res.headers.location).toBe('/en/enterprise-cloud@latest/copilot/concepts/chat') + expect(res.headers.location).toBe( + '/en/enterprise-cloud@latest/copilot/concepts/copilot-surfaces/copilot-on-github', + ) } }) @@ -30,15 +34,19 @@ describe('URL encoding for version paths', () => { }) test('handles URL-encoded @ symbol in second path segment', async () => { - const encodedUrl = '/enterprise-cloud%40latest/copilot/concepts/chat' + const encodedUrl = + '/enterprise-cloud%40latest/copilot/concepts/copilot-surfaces/copilot-on-github' const res = await get(encodedUrl) expect([301, 302]).toContain(res.statusCode) - expect(res.headers.location).toBe('/en/enterprise-cloud@latest/copilot/concepts/chat') + expect(res.headers.location).toBe( + '/en/enterprise-cloud@latest/copilot/concepts/copilot-surfaces/copilot-on-github', + ) }) test('normal @ symbol paths continue to work', async () => { - const normalUrl = '/en/enterprise-cloud@latest/copilot/concepts/chat' + const normalUrl = + '/en/enterprise-cloud@latest/copilot/concepts/copilot-surfaces/copilot-on-github' const res = await get(normalUrl) expect(res.statusCode).toBe(200) @@ -54,8 +62,9 @@ describe('URL encoding for version paths', () => { }) test('Express URL properties are correctly updated after decoding', async () => { - // Updating req.url must also refresh Express request properties such as req.path and req.query. - const encodedUrl = '/en/enterprise-cloud%40latest/copilot/concepts/chat?test=value' + // Test that req.path, req.query, etc. are properly updated when req.url is modified + const encodedUrl = + '/en/enterprise-cloud%40latest/copilot/concepts/copilot-surfaces/copilot-on-github?test=value' const res = await get(encodedUrl) // Middleware updates req.path from enterprise-cloud%40latest to enterprise-cloud@latest.