Cursor Cloud Agents
Свържете AI SmartTalk с Cursor Cloud Agents, за да стартирате автономни AI кодиращи асистенти директно от вашите разговори или работни потоци. Cursor Cloud Agents могат да четат хранилища, генерират код, създават комити и автоматично отварят pull заявки.
Преглед
Интеграцията на Cursor Cloud Agents ви позволява да:
- Стартирате AI кодиращи агенти на вашите GitHub хранилища
- Автоматизирате генерирането на код чрез инструкции на естествен език
- Създавате pull заявки автоматично, когато задачит е са завършени
- Наблюдавате напредъка на агента и преглеждате историята на разговорите
- Добавяте последващи инструкции на работещи агенти
- Инициирате кодиращи задачи от работни потоци SmartFlow
Предварителни условия
Преди да започнете, уверете се, че имате:
- Активен акаунт в AI SmartTalk
- Акаунт в Cursor с достъп до Cloud Agents
- API ключ на Cursor (получен от вашето табло на Cursor)
- GitHub хранилища, достъпни от вашия акаунт в Cursor
Стъпка по стъпка настройка
Стъпка 1: Получете вашия API ключ на Cursor
- Отидете на вашето табло на Cursor Cloud Agent
- Навигирайте до настройките на API
- Генерирайте нов API ключ за AI SmartTalk
- Копирайте API ключа
Стъпка 2: Достъп до интеграцията на Cursor
- Влезте в акаунта си в AI SmartTalk
- Навигирайте до Администрация → Моите асистенти → [Името на вашия асистент]
- Щракнете на Конектори в лявата странична лента
- Намерете Cursor Cloud Agents и щракнете върху него
Стъпка 3: Конфигурирайте връзката
- Щракнете Настройка на конфигурацията
- Въведете вашия API ключ на Cursor
- Щракнете Запази конфигурацията
- AI SmartTalk автоматично валидира вашия API ключ
Стъпка 4: Синхронизирайте хранилищата
След свързването AI SmartTalk автоматично синхронизира достъпните GitHub хранилища от вашия акаунт в Cursor. Можете също така ръчно да обновите списъка с хранилища по всяко време.
Табло
След свързването таблото за интеграция на Cursor предоставя пълен преглед:
Преглед на статистиката
| Метрика | Описание |
|---|---|
| Общо агенти | Брой стартирани агенти |
| Работи в момента | В момента активни агенти |
| Завършени | Завършени агенти |
| Налични модели | AI модели, налични за агенти |
Последни асистенти
Таблото изброява вашите най-нови агенти с:
- ID на агента за справка
- Статус: Работи, Завършен, Неуспешен, Създава се или Отменен
- Хранилище, по което работи агентът
- Дата на създаване
- Бързи действия: Преглед на детайли и Преглед на PR
Таблото автоматично се обновява на всеки 30 секунди, когато агентите работят.
Стартиране на агент
От таблото
- Щракнете Стартиране на нов асистент
- Попълнете формуляра за стартиране:
| Поле | Задължително | Описание |
|---|---|---|
| Хранилище | Да | Изберете GitHub хранилище от падащото меню |
| Описание на задачата | Да | Опишете какво трябва да направи агентът на естествен език |
| Клон | Не | Git клон, по който да работи (по подразбиране: main) |
| AI модел | Не | Изберете конкретен AI модел за агента |
| Автоматично създаване на PR | Не | Автоматично създаване на pull заявка, когато е готово (по подразбиране: включено) |
| Име на клона | Не | Персонализирано име на клон за pull заявката |
- Щракнете Стартиране на агента
Примери за описание на задачи
- "Добавете модулни тестове за модула за удостоверяване"
- "Рефакторирайте пуловете за свързване с базата данни, за да използвате рециклиране на връзки"
- "Поправете бъга, при който сесиите на потребителите изтичат преждевременно на мобилни устройства"
- "Добавете TypeScript типови определения за всички обекти на отговор от API"
- "Създайте REST API крайна точка за предпочитанията на потребителите"
Управление на агенти
Прегл ед на детайли на агента
Щракнете Преглед на детайли на всеки агент, за да видите:
Вкладка Преглед:
- ID на агента и текущ статус
- Информация за хранилището и клона
- Линк към pull заявка (ако е създадена)
- Резюме на извършената работа
- Времеви печат на създаване
Вкладка Разговор:
- Пълна история на съобщенията от работата на агента
- Инструкции от потребителя и отговори на AI
- Лог на напредъка стъпка по стъпка
Добавяне на последващи инструкции
Можете да изпратите допълнителни инструкции на работещ агент:
- Отворете детайлите на агента
- Въведете ва шата последваща инструкция (например, "Също така добавете обработка на грешки за граничния случай, когато потребителят не бъде намерен")
- Агентът продължава работата си с новия контекст
Изтриване на агент
За да почистите ресурсите:
- Щракнете върху действието за изтриване на картата на агента
- Потвърдете изтриването
- Агентът и ресурсите му се премахват
Интеграция със SmartFlow
Cursor Cloud Agents могат да се използват като действия в работни потоци SmartFlow, позволявайки мощни сценарии за автоматизация.
Налични действия в SmartFlow
| Действие | Описание |
|---|---|
| Стартиране на кодиращ агент | Започнете агент на хранилище с конкретни инструкции |
| Добавяне на последваща инструкция | Изпратете допълнителни инструкции на работещ агент |
| Получаване на статус на агента | Проверете напредъка и статуса на агента |
| Изтриване на агент | Премахнете агент и почистете ресурсите |
Пример: Автоматично поправяне на бъг
Trigger: Chat Service (when user reports a bug)
Actions:
1. AI Request:
Prompt: Extract the bug description and affected repository
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Fix this bug: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "I've launched a coding agent to fix this. I'll notify you when the PR is ready."
4. Wait / Poll:
Check Agent Status periodically
5. Send Message:
Text: "The fix is ready! Review the PR here: {{pr_url}}"
Пример: Планирани подобрения на кода
Trigger: Scheduled Workflow (weekly)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Review and update all deprecated dependencies"
Branch: chore/update-deps
Auto-create PR: true
За подробни параметри на действията в SmartFlow, вижте Cursor SmartFlow Actions.
Сценарии на употреба
Бот за поддръжка на разработчици
Позволете на потребителите да искат промени в кода чрез чат:
- "Можете ли да добавите валидация на входа за формата за регистрация?"
- "Моля, създайте скрипт за миграция за новите полета на потребителя"
Автоматизирано поправяне на бъгове
Инициирайте кодиращи агенти от доклади за бъгове или мониторингови предупреждения, за да автоматично генерирате PR за поправки.
Автоматизация на преглед на кода
Стартирайте агенти за преглед на код, добавяне на тестове или подобряване на документацията на базата на обратна връзка от PR.
Планирана поддръжка
Настройте повтарящи се работни потоци за обновяване на зависимости, извършване на корекции на линтинга или генериране на отчети.
Отстраняване на проблеми
| Проблем | Решение |
|---|---|
| "Невалиден API ключ" | Генерирайте отново вашия API ключ от таблото на Cursor |
| "Хранилището не е намерено" | Щракнете Обнови за повторна синхронизация на хранилищата. Уверете се, че хранилището е достъпно от вашия акаунт в Cursor |
| Агентът е заседнал в "Създава се" | Агентът може да е в опашка. Изчакайте няколко минути и проверете статуса отново |
| Агентът е неуспешен | Отворете детайлите на агента, за да видите разговора и съобщенията за грешки |
| PR не е създадена | Проверете дали автоматичното създаване на PR е било включено и агентът е завършил успешно |
| Няма налични хранилища | Уверете се, че вашият акаунт в Cursor има свързани GitHub хранилища |
Управление на интеграцията
| Действие | Как |
|---|---|
| Свържете | Въведете API ключа в конфигурацията на интеграцията |
| Преглед на таблото | Отворете страницата за интеграция на Cursor |
| Синхронизирайте хранилищата | Щракнете Обнови, за да актуализирате списъка с хранилища |
| Разединете | Премахнете API ключа от конфигурацията |
Най-добри практики
- Пишете ясни описания на задачите: Колкото по-специфични са инструкциите ви, толкова по-добър е изходът на агента.
- Използвайте подходящи клонове: Не стартирайте агенти директно на
main— оставете ги да създават PR за преглед. - Активирайте автоматичното създаване на PR: Това улеснява прегледа и сливането на работата на агента.
- Наблюдавайте работещите агенти: Проверявайте таблото редовно или настройте известия от SmartFlow.
- Прегледайте преди сливане: Винаги преглеждайте PR, генерирани от агенти, преди да ги слеете в продукция.
- Започнете малко: Започнете с добре определени задачи, преди да се опитате да направите големи рефакторизации.