Udostępnij za pośrednictwem

Korzystaj z wbudowanych i niestandardowych agentów w GitHub Copilot

Visual Studio zawiera zestaw wyselekcjonowanych wbudowanych agentów, które głęboko integrują się z funkcjami IDE, takimi jak debugowanie, profilowanie i testowanie. Możesz również tworzyć agentów niestandardowych dostosowanych do sposobu działania zespołu.

Wymagania wstępne

Uzyskiwanie dostępu do agentów niestandardowych

Dostęp do agentów niestandardowych jest możliwy na dwa sposoby:

  • Selektor agenta: W oknie czatu Copilot wybierz listę rozwijaną selektora agentów, aby wyświetlić dostępnych agentów. Obecnie ta opcja jest dostępna tylko w wersji Insider Visual Studio 2026.
  • @ składnia: wpisz nazwę agenta w danych wejściowych czatu (na przykład ).

Dostęp do agentów niestandardowych można uzyskać przy użyciu składni @: typ , po którym następuje nazwa agenta w danych wejściowych czatu (na przykład ).

Screenshot przedstawiający wybierak agentów z agentami niestandardowymi w Visual Studio.

Zrzut ekranu przedstawiający selektor agentów z agentami niestandardowymi.

Agenci wbudowani

Każdy wbudowany agent jest zaprojektowany wokół określonego przepływu pracy dewelopera i integruje się z natywnym narzędziami Visual Studio w sposób, w jaki asystent ogólny nie może.

Przedstawiciel Opis
@debugger Wykracza poza odczytywanie komunikatów o błędach. Używa stosów wywołań, stanu zmiennej i narzędzi diagnostycznych do systematycznego diagnozowania błędów w całym rozwiązaniu.
@profiler Łączy się z infrastrukturą profilowania Visual Studio w celu identyfikacji wąskich gardeł i zaproponowania ukierunkowanych optymalizacji opartych na Twojej bazie kodu, a nie ogólnych porad.
@test Generuje testy jednostkowe dostosowane do struktury i wzorców projektu, a nie szablony, które Twoja ciągła integracja odrzuci.
@unowocześnij (tylko .NET i C++) Obsługuje uaktualnienia platformy i zależności ze świadomością rzeczywistego grafu projektu. Wskazuje zmiany powodujące niekompatybilność, generuje kod migracji i działa zgodnie z istniejącymi wzorcami.
Przedstawiciel Opis
@profiler Łączy się z infrastrukturą do profilowania Visual Studio, aby zidentyfikować wąskie gardła oraz zasugerować ukierunkowane optymalizacje oparte na Twojej bazie kodu, a nie uniwersalne porady.

Korzystanie z agenta

Agent pomaga systematycznie diagnozować błędy, analizując kontekst debugowania.

Przykładowe podpowiedzi:

  • @debugger Why is this exception being thrown?
  • @debugger Analyze the current call stack and explain what went wrong
  • @debugger What's causing the null reference in this method?

Korzystanie z agenta

Agent @profiler łączy się z narzędziami profilowania Visual Studio, aby ułatwić identyfikowanie i rozwiązywanie problemów z wydajnością.

Przykładowe podpowiedzi:

  • @profiler Find the performance bottlenecks in my application
  • @profiler Why is this method taking so long to execute?
  • @profiler Suggest optimizations for the hot path

Korzystanie z agenta

Agent generuje testy jednostkowe zgodne ze strukturą testowania i konwencjami projektu.

Przykładowe podpowiedzi:

  • @test Generate unit tests for the selected method
  • @test Create tests that cover edge cases for this class
  • @test Write integration tests for this API endpoint

Aby uzyskać bardziej kompleksową obsługę testowania .NET, zobacz GitHub Copilot do testowania dla .NET.

Korzystanie z agenta

Agent @modernize pomaga w migracjach struktury i uaktualnieniach zależności dla projektów .NET i C++.

Przykładowe podpowiedzi:

  • @modernize Upgrade this project to .NET 8
  • @modernize What breaking changes should I expect when migrating?
  • @modernize Update deprecated API calls in this file

Agenci niestandardowi

Uwaga / Notatka

Agenci niestandardowi wymagają Visual Studio 2026 w wersji 18.4 lub nowszej.

Wbudowani agenci obejmują typowe przepływy pracy, ale twój zespół zna twój przepływ pracy najlepiej. Agenci niestandardowi pozwalają tworzyć własne przy użyciu tych samych podstaw: rozpoznawanie obszarów roboczych, interpretacja kodu, preferowany model sztucznej inteligencji i własne narzędzia.

Agenci niestandardowi stają się szczególnie zaawansowani w połączeniu z protokołem MCP (Model Context Protocol). Agentów można łączyć z zewnętrznymi źródłami wiedzy, takimi jak wewnętrzna dokumentacja, systemy projektowania, interfejsy API i bazy danych, dzięki czemu agent nie jest ograniczony do elementów w repozytorium.

Tworzenie agenta niestandardowego

Agenci niestandardowi są definiowani jako pliki w folderze repozytorium :

your-repo/
└── .github/
    └── agents/
        └── code-reviewer.agent.md

Format pliku agenta

Każdy plik agenta używa prostego szablonu z frontmatterem YAML, a następnie instrukcjami języka Markdown:

---
name: Code Reviewer
description: Reviews PRs against our team's coding standards
model: claude-opus-4-6
tools: ["code_search", "readfile", "find_references"]
---

You are a code reviewer for our team. When reviewing changes, check for:

- Naming conventions: PascalCase for public methods, camelCase for private
- Error handling: all async calls must have try/catch with structured logging
- Test coverage: every public method needs at least one unit test

Flag violations clearly and suggest fixes inline.

Właściwości frontmatteru

Majątek Wymagane Opis
name Nie. Nazwa wyświetlana agenta w selektorze agenta. Jeśli nie zostanie określona, nazwa agenta pochodzi z nazwy pliku (na przykład staje się ).
description Tak Krótki opis wyświetlany podczas najechania wskaźnikiem myszy na agenta
model Nie. Model sztucznej inteligencji do użycia. Jeśli nie zostanie określony, użyje modelu wybranego w selektorze modelu.
tools Nie. Tablica nazw narzędzi, których może używać agent. Jeśli nie zostanie to określone, wszystkie dostępne narzędzia zostaną włączone.

Określanie narzędzi

Narzędzia rozszerzają możliwości agenta niestandardowego. Możesz określić narzędzia, których agent powinien używać w tablicy .

Ważna

Nazwy narzędzi różnią się w zależności od platform GitHub Copilot. Sprawdź narzędzia dostępne w Visual Studio specjalnie, aby upewnić się, że agent działa zgodnie z oczekiwaniami. Wybierz ikonę Narzędzia w oknie czatu, aby wyświetlić dostępne nazwy narzędzi.

Połącz się ze źródłami zewnętrznymi za pomocą MCP

Dzięki serwerom MCP agenci niestandardowi mogą uzyskiwać dostęp do zewnętrznych źródeł wiedzy:

  • Wewnętrzna dokumentacja i witryny typu wiki
  • Projektowanie systemów i bibliotek składników
  • Interfejsy API i bazy danych
  • Przewodniki stylu i repozytoria ADR

Na przykład agent przeglądu kodu może sprawdzić pull requesty względem rzeczywistych konwencji, łącząc się z przewodnikiem po stylu za pośrednictwem MCP.

Przykładowi agenci niestandardowi

Agent przeglądu kodu

---
name: Code Reviewer
description: Reviews code against our team's coding standards
tools: ["code_search", "readfile"]
---

You are a code reviewer for our team. Review changes for:

1. **Naming conventions**: PascalCase for public methods, camelCase for private fields
2. **Error handling**: All async calls must have try/catch with structured logging
3. **Test coverage**: Every public method needs at least one unit test
4. **Documentation**: Public APIs must have XML documentation comments

Flag violations clearly and suggest fixes inline.

Agent planowania

---
name: Feature Planner
description: Helps plan features before writing code
tools: ["code_search", "readfile", "find_references"]
---

You are a planning assistant. When asked about a feature:

1. Gather requirements by asking clarifying questions
2. Identify affected files and components in the codebase
3. Break down the work into discrete tasks
4. Flag potential risks or dependencies
5. Create a structured plan that can be handed off for implementation

Focus on understanding scope before suggesting solutions.

Agent systemu projektowania

---
name: Design System
description: Enforces UI design patterns and component usage
tools: ["code_search", "readfile"]
---

You are a design system expert. When reviewing UI code:

1. Check that standard components are used instead of custom implementations
2. Verify spacing and layout follow the design token system
3. Ensure accessibility requirements are met (ARIA labels, keyboard navigation)
4. Flag any UI drift from established patterns

Reference the component library documentation when suggesting fixes.

Agent rozwoju full-stack z narzędziami Visual Studio

W poniższym przykładzie użyto nazw narzędzi specyficznych dla Visual Studio:

---
name: Full Stack Dev
description: Full-stack development assistant with search, file editing, and terminal access
tools: ["code_search", "readfile", "editfiles", "find_references", "runcommandinterminal", "getwebpages"]
---

You are a full-stack development assistant. Help with:

1. Searching the codebase to understand existing patterns
2. Reading and editing files to implement changes
3. Running build and test commands to verify your work
4. Looking up documentation when needed

Always check existing code conventions before making changes.

Wskazówka

Wybierz ikonę Tools w oknie czatu Copilot, aby wyświetlić wszystkie dostępne nazwy narzędzi w wersji Visual Studio.

Konfiguracje społeczności

Repozytorium awesome-copilot ma konfiguracje agentów współtworzynych przez społeczność, których można użyć jako punktów początkowych. W przypadku korzystania z konfiguracji z tego repozytorium przed wdrożeniem w zespole sprawdź, czy nazwy narzędzi działają w Visual Studio.

Ograniczenia i uwagi

  • Jeśli nie określisz modelu, agent używa dowolnego modelu wybranego w selektorze modelu.
  • Nazwy narzędzi różnią się w zależności od platform GitHub Copilot. Przed wdrożeniem w zespole sprawdź, czy nazwy narzędzi działają w Visual Studio.

Podziel się opinią

Udostępnij konfiguracje agenta niestandardowego w repozytorium awesome-copilot lub prześlij opinię za pośrednictwem Visual Studio Developer Community. Przepływy pracy ułatwiają kształtowanie przyszłych funkcji.

Treści powiązane

  • Last updated on