Глоссарий терминов¶
Справочник терминов, используемых в документации Koda.
Для быстрой навигации используйте поиск по странице и алавитный указатель.
A¶
Agent (Агент)¶
Режим работы Koda для выполнения многошаговых задач с изменением файлов. Агент подходит, когда нужно не просто получить ответ, а выполнить серию связанных действий, направленных на изменение проекта.
См. также: Режим агента
API Key (API-ключ)¶
Уникальный ключ для доступа к API провайдера моделей (OpenAI, Anthropic и др.).
Autocomplete (Автодополнение, Completion)¶
Режим мгновенных подсказок кода во время набора текста. Koda предлагает продолжение кода с учётом контекста файла и проекта. Подсказки отображаются как «призрак» (серый текст) и принимаются нажатием Tab.
См. также: Автодополнение кода
Chat (Чат)¶
Режим работы Koda для выполнения многошаговых задач без изменения файлов. Чат подходит, когда нужно изучить проект, найти нужные места, предложить изменения, проверить результат.
C¶
Chunks (Чанки)¶
Фрагменты текста, на которые разбивается код или документация при индексации. Каждый чанк содержит ограниченное количество токенов и используется для векторного поиска.
Context (Контекст)¶
Дополнительная информация, которую Koda использует для генерации ответов. Контекст может включать файлы, выделенный код, документацию, изменения git, вывод терминала и другие источники.
Context Providers (Контекст-провайдеры)¶
Источники данных для добавления контекста в запросы к AI. Каждый провайдер отвечает за определённый тип информации: файлы, код, документацию, терминал и т.д.
См. также: Контекст-провайдеры
Конфигурационный файл (config.yaml)¶
Файл настроек Koda в формате YAML. Хранит конфигурацию моделей, контекст-провайдеров, правил, промптов и других параметров.
См. также: Справочник YAML
D¶
Diff¶
Разница между двумя версиями текста. В Koda используется для показа предложенных изменений перед применением, а также для добавления изменений git в контекст.
E¶
Edit¶
Режим редактирования кода на основе инструкций пользователя. Выделенный участок кода отправляется модели с инструкцией, модель генерирует изменения, которые применяются как diff.
Embeddings (Эмбеддинги)¶
Векторные представления текста для семантического поиска. Используются для индексации кодовой базы и документации, позволяя находить релевантный код по смыслу, а не по точному совпадению.
I¶
Indexing (Индексация)¶
Процесс анализа и векторизации кодовой базы для семантического поиска. Koda разбивает код на чанки, создаёт эмбеддинги и сохраняет их в локальный индекс.
См. также: Codebase Provider
K¶
KODA.md¶
Контекстный файл проекта с правилами и техническими подробностями.
Создаётся слеш-командой /kodamd и содержит информацию о технологиях, стиле кода и структуре проекта.
См. также: Слеш-команды
L¶
LLM (Large Language Model, ИИ-модель, AI-модель, модель)¶
Большая языковая модель, используемая для генерации текста и кода.
LSP (Language Server Protocol)¶
Протокол для интеграции языковых возможностей в редакторы кода. Koda использует LSP для получения информации об определениях, типах и импортах, что улучшает качество автодополнения.
M¶
MCP (Model Context Protocol)¶
Протокол для подключения внешних источников контекста и инструментов. MCP-серверы предоставляют дополнительные возможности: доступ к базам данных, API, файловой системе и другим ресурсам.
:simple/modelcontextprotocol: Компоненты MCP:
- Tools — инструменты для выполнения действий
- Resources — данные для чтения
- Prompts — шаблоны промптов
Модели (Models)¶
Языковые модели AI, используемые для генерации ответов. Koda поддерживает различные модели через провайдеров: OpenAI, Anthropic, Ollama и другие.
N¶
NEP/NES (Next Edit Prediction/Suggestion)¶
Продвинутая функция автодополнения, предсказывающая следующие правки кода. Анализирует действия пользователя и предсказывает вероятные редактирования до того, как пользователь начнёт печатать.
См. также: NEP
P¶
Prompt (Промпт)¶
Текстовый запрос к AI-модели. Содержит инструкцию, контекст и дополнительную информацию для генерации ответа.
Provider (Провайдер)¶
Сервис, предоставляющий доступ к AI-моделям (OpenAI, Anthropic, Ollama и др.).
R¶
RAG (Retrieval-Augmented Generation)¶
Технология генерации ответов с использованием внешних источников данных. Koda использует RAG для поиска релевантного контекста в кодовой базе и документации перед генерацией ответа.
Rules (Правила)¶
Инструкции, которым должна следовать модель при генерации ответов. Объединяются в системное сообщение для всех запросов Chat, Edit и Agent.
См. также: Правила
RepoMap (Карта репозитория)¶
Представление структуры проекта в виде графа зависимостей. Используется для быстрого обзора архитектуры и навигации по кодовой базе.
См. также: Контекст-провайдеры
S¶
Session (Сессия) — отдельный диалог в чате Koda со своей историей и контекстом.
Session History (История сессий) — список всех предыдущих сессий с возможностью поиска, переключения и удаления.
Session Storage (Хранилище сессий) — место сохранения данных сессий (локальные файлы ~/.koda/sessions/ или серверное хранилище).
Skills (Навыки, Скиллы)¶
Переиспользуемые инструкции для AI в формате markdown.
Навыки хранятся в файлах SKILL.md и активируются автоматически или по явному запросу.
Slash Commands (Слеш-команды)¶
Предопределённые промпты, начинающиеся с символа /.
Упрощают работу с AI, предоставляя готовые сценарии для типовых задач.
См. также: Слеш-команды
Summarization (Суммаризация)¶
Процесс сжатия длинных диалогов в краткий конспект. Используется для предотвращения переполнения контекста (которое ведёт к отказу модели в обработке запроса) и смешения контекста (когда накопленные за сессию сведения противоречат друг другу, что мешает модели сгенерировать правильный ответ).
См. также: Суммаризация
T¶
Token (Токен)¶
В контексте ИИ: Единицы измерения длины текста для AI моделей. Один токен может соответствовать примерно 4 символам или 0.75 слова на английском языке.
В контексте взаимодействия сервисов: Ключ, который подтверждает легитимность запроса к серверу. Сервер проверяет API-токен и (не) выдаёт разрешение на чтение или изменение данных.
Tool (Инструмент)¶
Подпрограмма, информация о которой попадает в контекст модели и которую модель может вызвать для выполнения действия (прочитать файл, отредактировать код, запустить команду и пр.). Всегда имеет своё уникальное название и описание.
W¶
Workspace (Рабочая область)¶
Проект или директория, открытая в IDE.