Skip to main content

Обзор @ Mentions

@ mentions – одна из самых мощных функций Careti, позволяющая беспрепятственно переносить внешний контекст в ваши разговоры. Вместо того чтобы копировать и вставлять код, сообщения об ошибках или документацию, вы можете просто ссылаться на них с помощью символа @.

@ Mentions Overview

Когда вы вводите @ в поле ввода чата, Careti показывает меню доступных типов упоминаний. Эти упоминания позволяют вам ссылаться на файлы, папки, проблемы, вывод терминала, изменения в системе контроля версий git и даже веб-контент непосредственно в ваших разговорах.

Доступные @ Mentions​

Careti поддерживает несколько типов @ mentions, каждый из которых предназначен для привнесения различных видов контекста в ваши разговоры:

File Mentions

Ссылайтесь на любой файл в вашей рабочей области с помощью @/path/to/file. Careti видит полное содержимое файла, включая импорты, связанные функции и окружающий контекст.

Folder Mentions

Ссылайтесь на целые каталоги с помощью @/path/to/folder/. Careti видит структуру папок и все содержимое файлов, что идеально подходит для понимания сложных взаимодействий между несколькими файлами.

Problem Mentions

Используйте @problems, чтобы показать Careti все ошибки и предупреждения в вашей рабочей области. Careti видит полный список с указанием местоположения файлов и сообщений об ошибках.

Terminal Mentions

Используйте @terminal, чтобы поделиться выводом вашего недавнего терминала. Careti видит полный вывод с сохраненным форматированием, что идеально подходит для отладки ошибок сборки или сбоев тестов.

Git Mentions

Ссылайтесь на незафиксированные изменения с помощью @git-changes или на определенные коммиты с помощью @[commit-hash]. Careti видит полный diff, сообщение коммита и другую релевантную информацию.

URL Mentions

Ссылайтесь на веб-контент с помощью @https://example.com. Careti извлекает и видит полное содержимое веб-страницы, что идеально подходит для ссылок на документацию или issues на GitHub.

Почему @ Mentions Имеют Значение​

@ mentions преобразуют способ вашего взаимодействия с Careti посредством:

  1. Устранения копирования и вставки: Больше не нужно копировать и вставлять код, сообщения об ошибках или вывод терминала. Просто ссылайтесь на них напрямую.

  2. Сохранения контекста: Careti видит полный контекст, включая импорты, связанные функции и окружающий код, который может иметь отношение к делу.

  3. Поддержания форматирования: Вывод терминала, сообщения об ошибках и веб-контент сохраняют свое форматирование, что облегчает их понимание.

  4. Включения сложных рабочих процессов: Объедините несколько @ mentions, чтобы дать Careti полное представление о вашей проблеме:

    Я получаю следующие ошибки: @problems

    Вот мой компонент: @/src/components/Form.jsx
    И API endpoint: @/src/api/users.js

    Ошибка происходит, когда я отправляю форму: @terminal

    Я думаю, что этот коммит мог вызвать это: @a1b2c3d

С чего начать​

Чтобы использовать @ mentions:

  1. Введите @ в поле ввода чата
  2. Выберите тип упоминания из меню или продолжайте вводить текст
  3. Для файлов и папок перейдите к нужному элементу в структуре вашей рабочей области
  4. Отправьте свое сообщение как обычно

Careti автоматически обработает упоминания и включит указанное содержимое в контекст, отправляемый AI.

Попробуйте использовать @ mentions в вашем следующем разговоре с Careti - вы будете поражены тем, насколько более эффективными и продуктивными станут ваши взаимодействия, когда вы сможете беспрепятственно привлекать внешний контекст.

Как это работает под капотом​

Когда вы используете @ mentions в своих сообщениях, за кулисами происходит сложный процесс:

  1. Обнаружение: Когда вы отправляете сообщение, Careti сканирует текст на наличие шаблонов @ mention, используя регулярные выражения

  2. Обработка: Для каждого обнаруженного упоминания Careti:

    • Определяет тип упоминания (файл, папка, проблемы, терминал, git, URL)
    • Извлекает соответствующий контент (содержимое файла, вывод терминала и т.д.)
    • Форматирует контент соответствующим образом

  3. Улучшение: Исходное сообщение дополняется структурированными данными:

    Ваше исходное сообщение с @/path/to/file

    <file_content path="/path/to/file">
    [Полное содержимое файла]
    </file_content>

  4. Включение контекста: Это улучшенное сообщение со всем встроенным контентом отправляется в AI модель

  5. Бесшовный ответ: Теперь AI может "видеть" весь указанный контент, как если бы вы скопировали и вставили его вручную

Весь этот процесс происходит автоматически и беспрепятственно всякий раз, когда вы используете @ mentions, предоставляя AI полный контекст без необходимости копировать что-либо вручную.

Каждый тип @ mention имеет свои собственные детали реализации, которые вы можете найти на соответствующих страницах документации.