Cursor Cloud Agents
Połącz AI SmartTalk z Cursor Cloud Agents, aby uruchomić autonomiczne asystentów kodowania AI bezpośrednio z Twoich rozmów lub przepływów pracy. Cursor Cloud Agents mogą przeglądać repozytoria, generować kod, tworzyć commity i automatycznie otwierać pull requesty.
Przegląd
Integracja Cursor Cloud Agents umożliwia Ci:
- Uruchamianie agentów kodowania AI na Twoich repozytoriach GitHub
- Automatyzację generowania kodu za pomocą instrukcji w naturalnym języku
- Automatyczne tworzenie pull requestów po zakończeniu zadań
- Monitorowanie postępu agenta i przeglądanie historii rozmów
- Dodawanie instrukcji uzupełniających do działających agentów
- Wywoływanie zadań kodowania z przepływów pracy SmartFlow
Wymagania wstępne
Zanim zaczniesz, upewnij się, że masz:
- Aktywne konto AI SmartTalk
- Konto Cursor z dostępem do Cloud Agents
- Klucz API Cursor (uzyskany z pulpitu nawigacyjnego Cursor)
- Repozytoria GitHub dostępne z Twojego konta Cursor
Instrukcje krok po kroku
Krok 1: Uzyskaj swój klucz API Cursor
- Przejdź do swojego pulpitu nawigacyjnego Cursor Cloud Agent
- Przejdź do ustawień API
- Wygeneruj nowy klucz API dla AI SmartTalk
- Skopiuj klucz API
Krok 2: Uzyskaj dostęp do integracji Cursor
- Zaloguj się na swoje konto AI SmartTalk
- Przejdź do Administracja → Moi Asystenci → [Nazwa Twojego Asystenta]
- Kliknij na Konektory w lewym pasku bocznym
- Zlokalizuj Cursor Cloud Agents i kliknij na to
Krok 3: Skonfiguruj połączenie
- Kliknij Ustaw konfigurację
- Wprowadź swój Klucz API Cursor
- Kliknij Zapisz konfigurację
- AI SmartTalk automatycznie weryfikuje Twój klucz API
Krok 4: Synchronizuj repozytoria
Po połączeniu, AI SmartTalk automatycznie synchronizuje dostępne repozytoria GitHub z Twojego konta Cursor. Możesz również ręcznie odświeżyć listę repozytoriów w dowolnym momencie.
Pulpit nawigacyjny
Po połączeniu, pulpit nawigacyjny integracji Cursor zapewnia pełny przegląd:
Przegląd statystyk
| Metryka | Opis |
|---|---|
| Łączna liczba agentów | Liczba uruchomionych agentów |
| Działające | Obecnie aktywne agenty |
| Zakończone | Zakończone agenty |
| Dostępne modele | Modele AI dostępne dla agentów |
Ostatni asystenci
Pulpit nawigacyjny wyświetla Twoje najnowsze agenty z:
- ID agenta do odniesienia
- Status: Działający, Zakończony, Nieudany, Tworzenie lub Anulowany
- Repozytorium, nad którym pracuje agent
- Data utworzenia
- Szybkie akcje: Zobacz szczegóły i Zobacz PR
Pulpit nawigacyjny automatycznie odświeża się co 30 sekund, gdy agenty są aktywne.
Uruchamianie agenta
Z pulpitu nawigacyjnego
- Kliknij Uruchom nowego asystenta
- Wypełnij formularz uruchomienia:
| Pole | Wymagane | Opis |
|---|---|---|
| Repozytorium | Tak | Wybierz repozytorium GitHub z rozwijanej listy |
| Opis zadania | Tak | Opisz, co agent powinien zrobić w naturalnym języku |
| Gałąź | Nie | Gałąź Git, nad którą ma pracować (domyślnie: main) |
| Model AI | Nie | Wybierz konkretny model AI dla agenta |
| Automatyczne tworzenie PR | Nie | Automatycznie utwórz pull request po zakończeniu (domyślnie: włączone) |
| Nazwa gałęzi | Nie | Niestandardowa nazwa gałęzi dla pull requestu |
- Kliknij Uruchom agenta
Przykłady opisów zadań
- "Dodaj testy jednostkowe dla modułu uwierzytelniania"
- "Refaktoryzuj pulę połączeń z bazą danych, aby używała recyklingu połączeń"
- "Napraw błąd, w którym sesje użytkowników wygasają przedwcześnie na urządzeniach mobilnych"
- "Dodaj definicje typów TypeScript dla wszystkich obiektów odpowiedzi API"
- "Utwórz punkt końcowy REST API dla preferencji użytkowników"
Zarządzanie agentami
Zobacz szczegóły agenta
Kliknij Zobacz szczegóły na dowolnym agencie, aby zobaczyć:
Zakładka przeglądu:
- ID agenta i aktualny status
- Informacje o repozytorium i gałęzi
- Link do pull requestu (jeśli został utworzony)
- Podsumowanie wykonanej pracy
- Znacznik czasu utworzenia
Zakładka rozmowy:
- Pełna historia wiadomości dotycząca pracy agenta
- Instrukcje użytkownika i odpowiedzi AI
- Dziennik postępu krok po kroku
Dodaj instrukcje uzupełniające
Możesz wysłać dodatkowe instrukcje do działającego agenta:
- Otwórz szczegóły agenta
- Wprowadź swoją instrukcję uzupełniającą (np. "Dodaj również obsługę błędów dla przypadku brzegowego, gdy użytkownik nie zostanie znaleziony")
- Agent kontynuuje swoją pracę z nowym kontekstem
Usuń agenta
Aby oczyścić zasoby:
- Kliknij akcję usunięcia na karcie agenta
- Potwierdź usunięcie
- Agent i jego zasoby zostaną usunięte
Integracja SmartFlow
Cursor Cloud Agents mogą być używane jako akcje w przepływach pracy SmartFlow, umożliwiając potężne scenariusze automatyzacji.
Dostępne akcje SmartFlow
| Akcja | Opis |
|---|---|
| Uruchom agenta kodowania | Rozpocznij agenta w repozytorium z określonymi instrukcjami |
| Dodaj uzupełnienie | Wyślij dodatkowe instrukcje do działającego agenta |
| Sprawdź status agenta | Sprawdź postęp i status agenta |
| Usuń agenta | Usuń agenta i oczyść zasoby |
Przykład: Automatyczna naprawa w zgłoszeniu błędu
Trigger: Chat Service (gdy użytkownik zgłasza błąd)
Actions:
1. AI Request:
Prompt: Wyodrębnij opis błędu i dotknięte repozytorium
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Napraw ten błąd: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Uruchomiłem agenta kodowania, aby to naprawić. Powiadomię Cię, gdy PR będzie gotowy."
4. Wait / Poll:
Sprawdzaj status agenta okresowo
5. Send Message:
Text: "Naprawa jest gotowa! Przejrzyj PR tutaj: {{pr_url}}"
Przykład: Zaplanowane ulepszenia kodu
Trigger: Scheduled Workflow (co tydzień)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Przejrzyj i zaktualizuj wszystkie przestarzałe zależności"
Branch: chore/update-deps
Auto-create PR: true
Aby uzyskać szczegółowe parametry akcji SmartFlow, zobacz Cursor SmartFlow Actions.
Przykłady użycia
Bot wsparcia dewelopera
Pozwól użytkownikom zgłaszać zmiany w kodzie przez czat:
- "Czy możesz dodać walidację wejścia do formularza rejestracji?"
- "Proszę utworzyć skrypt migracji dla nowych pól użytkownika"
Automatyczne naprawianie błędów
Wywołuj agentów kodowania z zgłoszeń błędów lub alertów monitorujących, aby automatycznie generować PR-y naprawcze.
Automatyzacja przeglądów kodu
Uruchamiaj agentów do przeglądania kodu, dodawania testów lub poprawy dokumentacji na podstawie opinii PR.
Zaplanowana konserwacja
Ustaw regularne przepływy pracy, aby aktualizować zależności, uruchamiać poprawki lintingowe lub generować raporty.
Rozwiązywanie problemów
| Problem | Rozwiązanie |
|---|---|
| "Nieprawidłowy klucz API" | Wygeneruj ponownie swój klucz API z pulpitu nawigacyjnego Cursor |
| "Repozytorium nie znalezione" | Kliknij Odśwież, aby ponownie zsynchronizować repozytoria. Upewnij się, że repozytorium jest dostępne z Twojego konta Cursor |
| Agent utknął w "Tworzeniu" | Agent może być w kolejce. Poczekaj kilka minut i sprawdź status ponownie |
| Agent nie powiódł się | Otwórz szczegóły agenta, aby zobaczyć rozmowę i komunikaty o błędach |
| PR nie został utworzony | Sprawdź, czy automatyczne tworzenie PR było włączone i czy agent zakończył się pomyślnie |
| Brak dostępnych repozytoriów | Upewnij się, że Twoje konto Cursor ma połączone repozytoria GitHub |
Zarządzanie integracją
| Akcja | Jak |
|---|---|
| Połącz | Wprowadź klucz API w konfiguracji integracji |
| Zobacz pulpit nawigacyjny | Otwórz stronę integracji Cursor |
| Synchronizuj repozytoria | Kliknij Odśwież, aby zaktualizować listę repozytoriów |
| Odłącz | Usuń klucz API z konfiguracji |
Najlepsze Praktyki
- Pisanie jasnych opisów zadań: Im bardziej szczegółowe są Twoje instrukcje, tym lepszy będzie wynik agenta.
- Używaj odpowiednich gałęzi: Nie uruchamiaj agentów bezpośrednio na
main— pozwól im tworzyć PR-y do przeglądu. - Włącz automatyczne tworzenie PR: Ułatwia to przeglądanie i scalanie pracy agenta.
- Monitoruj działających agentów: Regularnie sprawdzaj pulpit nawigacyjny lub skonfiguruj powiadomienia SmartFlow.
- Przeglądaj przed scaleniem: Zawsze przeglądaj PR-y generowane przez agenta przed scaleniem do produkcji.
- Zacznij od małych zadań: Rozpocznij od dobrze zdefiniowanych zadań, zanim spróbujesz dużych refaktoryzacji.