> ## Documentation Index > Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt > Use this file to discover all available pages before exploring further. # Использование APIMart в AnythingLLM > Подробное руководство по настройке и использованию API-сервиса APIMart в AnythingLLM. Этот гайд поможет настроить APIMart API в AnythingLLM для создания приватных AI-баз знаний и диалоговых систем. ## Предварительные требования Перед началом убедитесь: 1. **AnythingLLM установлен**\ Скачайте и установите AnythingLLM с [официального сайта](https://anythingllm.com/) или посетите [GitHub](https://github.com/Mintplex-Labs/anything-llm) 2. **Получен API-ключ APIMart**\ Войдите в [консоль APIMart](https://apimart.ai/keys), чтобы получить API-ключ (начинается с `sk-`) **Совет:** если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на [APIMart](https://apimart.ai) и получите API-ключ. ## Шаг 1: Запустите AnythingLLM и откройте настройки ### 1.1 Запустите приложение 1. Запустите десктоп-приложение AnythingLLM или зайдите в веб-версию 2. При первом запуске появится приветственный экран 3. Нажмите кнопку **Open settings** в нижнем левом углу AnythingLLM Main Interface *Главный интерфейс AnythingLLM со списком рабочих пространств и доступом к настройкам* **Примечание:** AnythingLLM поддерживает десктоп-версии (Windows, macOS, Linux) и развёртывание Docker. ### 1.2 Перейдите к конфигурации LLM На странице настроек: 1. Найдите **LLM Preference** в левом меню 2. Кликните, чтобы открыть страницу конфигурации LLM ## Шаг 2: Настройте API APIMart ### 2.1 Выберите провайдера LLM На странице конфигурации LLM: 1. Найдите выпадающее меню **LLM Provider** 2. Выберите **Generic OpenAI** LLM Provider Selection *Выберите Generic OpenAI в качестве провайдера LLM* **Почему Generic OpenAI?** APIMart предоставляет OpenAI-совместимый API-интерфейс, поэтому выбор провайдера Generic OpenAI в AnythingLLM позволяет использовать сервисы APIMart. ### 2.2 Настройте данные API После выбора Generic OpenAI заполните следующую конфигурацию: | Поле | Значение | | ---------------------------------- | ------------------------------------------------------------- | | **API Key** | Ваш API-ключ APIMart (`sk-xxxxxxxxxxxx`) | | **Base URL** или **API Base Path** | `https://api.apimart.ai/v1` | | **Chat Model** или **Model Name** | Введите конкретное имя модели (см. рекомендуемые модели ниже) | API Configuration *Заполните API Key APIMart, Base URL и имя модели* **Важно:** * Base URL должен включать суффикс `/v1`: `https://api.apimart.ai/v1` * API Key должен быть получен из консоли APIMart и начинаться с `sk-` * Имя модели должно быть точным ID модели (например, `gpt-4o`, `claude-sonnet-4-5-20250929` и т. д.) * Убедитесь, что на API-ключе достаточный баланс **Рекомендуемые модели:** | Имя модели | ID модели | Особенности | | ----------------- | -------------------------------- | ---------------------------------- | | GPT-5 | `gpt-5` | Последняя и самая мощная | | GPT-4o | `gpt-4o` или `chatgpt-4o-latest` | Высококачественный диалог | | GPT-4o Mini | `gpt-4o-mini` | Быстрая и экономичная | | Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929` | Превосходна для кода и рассуждений | | Claude Haiku 4.5 | `claude-haiku-4-5-20251001` | Быстрый ответ | | Gemini 2.0 Flash | `gemini-2.0-flash-exp` | Поддержка мультимодальности | **Рекомендации по производительности:** * 💰 **Выгодные:** `gpt-4o-mini`, `claude-haiku-4-5-20251001` * 🚀 **Производительные:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` * ⚡ **Быстрый ответ:** `gemini-2.0-flash-exp`, `gpt-4o-mini` ### 2.3 Настройте параметры модели (необязательно) Можно настроить следующие параметры по необходимости: | Параметр | Описание | Рекомендуемое значение | | --------------- | ------------------------------- | ----------------------------------- | | **Temperature** | Контролирует случайность вывода | 0,7 (креативность) / 0,3 (точность) | | **Max Tokens** | Максимальная длина вывода | 2000-4000 | | **Top P** | Параметр nucleus sampling | 0,9 | ### 2.4 Сохраните конфигурацию 1. Нажмите кнопку **Save** внизу страницы 2. Система автоматически проверит подключение 3. Появится сообщение об успехе, если конфигурация верна ## Шаг 3: Настройте Embedding-модель (необязательно) AnythingLLM поддерживает векторные эмбеддинги для поиска документов и функциональности базы знаний. ### 3.1 Перейдите к настройкам Embedding На странице настроек: 1. Найдите **Embedding Preference** в левом меню 2. Кликните, чтобы открыть страницу конфигурации embedding-модели ### 3.2 Настройте Embedding-модель | Поле | Значение | | ---------------------- | ----------------------------------------------------- | | **Embedding Provider** | Выберите **Generic OpenAI** | | **API Key** | Ваш API-ключ APIMart (`sk-xxxxxxxxxxxx`) | | **Base URL** | `https://api.apimart.ai/v1` | | **Model** | `text-embedding-3-small` или `text-embedding-3-large` | **Рекомендации по выбору модели:** * `text-embedding-3-small` — быстрая и экономичная, подходит для большинства сценариев * `text-embedding-3-large` — более высокая точность, подходит для сценариев с высокими требованиями к качеству поиска ## Шаг 4: Создайте рабочее пространство и загрузите документы ### 4.1 Создайте рабочее пространство 1. Вернитесь в главный интерфейс 2. Нажмите **+ New Workspace** 3. Введите имя рабочего пространства (например, «Помощник по технической документации», «База знаний клиентского сервиса») 4. Нажмите Create ### 4.2 Загрузите документы AnythingLLM поддерживает различные форматы документов: **Поддерживаемые типы документов:** * 📄 **Текстовые документы** — .txt, .md, .pdf, .docx * 💻 **Файлы кода** — .py, .js, .java, .cpp и т. д. * 🌐 **Веб-страницы** — через скрапинг по URL * 📊 **Файлы данных** — .csv, .json, .xml **Шаги загрузки:** 1. На странице рабочего пространства нажмите **Upload Documents** 2. Выберите файлы или перетащите их в область загрузки 3. Дождитесь завершения обработки документов 4. Документы будут автоматически векторизованы **Обработка документов:** загруженные документы автоматически разбиваются на части и векторизуются с помощью embedding-модели, сохраняются в локальной базе. ### 4.3 Управляйте документами На странице управления документами: 1. Просматривайте все загруженные документы 2. Удаляйте ненужные документы 3. Просматривайте детали разбиения документов 4. Редактируйте метаданные документов ## Шаг 5: Начните диалог После настройки можно начать использовать AnythingLLM: ### 5.1 Базовые диалоги 1. В рабочем пространстве найдите поле ввода диалога 2. Введите ваш вопрос или запрос 3. ИИ сгенерирует ответы на основе загруженных документов и моделей APIMart ### 5.2 Использование функции базы знаний AnythingLLM будет автоматически: 1. Анализировать ваш вопрос 2. Извлекать релевантный контент из загруженных документов 3. Генерировать точные ответы, комбинируя извлечённый контент и AI-модель **Улучшение качества поиска:** * Загружайте качественные, структурированные документы * Используйте чёткие, конкретные вопросы * Регулярно обновляйте и поддерживайте базу знаний ### 5.3 Переключайтесь между рабочими пространствами Можно создавать несколько рабочих пространств для разных проектов или тем: 1. Кликните на имя рабочего пространства в левом верхнем углу 2. Выберите другие рабочие пространства или создайте новые 3. У каждого рабочего пространства независимые документы и история диалогов ## Расширенные возможности ### 1. Режим Agent AnythingLLM поддерживает функциональность Agent, позволяющую ИИ: * 🔍 **Искать в вебе** — получать актуальную информацию * 🧮 **Выполнять расчёты** — обрабатывать математику и анализ данных * 📊 **Создавать графики** — визуализировать данные * 🔗 **Вызывать API** — взаимодействовать с внешними сервисами **Включение режима Agent:** 1. Найдите **Agent Configuration** в настройках рабочего пространства 2. Выберите инструменты и функции для включения 3. Сохраните конфигурацию ### 2. Управление историей диалогов * **Экспорт диалогов** — экспортируйте диалоги в текст или JSON * **Поиск по истории** — быстро находите исторические диалоги * **Удаление записей** — очищайте ненужную историю диалогов ### 3. Кастомные системные промпты В настройках рабочего пространства: 1. Найдите **System Prompt** 2. Настройте роль и поведение ИИ 3. Пример: ``` You are a professional technical support engineer, skilled at answering technical questions about products. When answering, please: 1. Maintain professionalism and courtesy 2. Provide detailed step-by-step instructions 3. If uncertain, recommend contacting technical support ``` ### 4. Управление несколькими пользователями (только Docker) Если используется развёртывание Docker: * Создавайте несколько учётных записей пользователей * Устанавливайте разные уровни доступа * Управляйте правами доступа к рабочим пространствам ### 5. Доступ к API AnythingLLM предоставляет REST API для: * Программного доступа к рабочим пространствам * Загрузки и управления документами * Отправки запросов диалога * Интеграции в ваши приложения ## Часто задаваемые вопросы ### Q1: Не удаётся подключиться к сервису APIMart? **Решение:** 1. **Проверьте Base URL**: * Убедитесь, что это `https://api.apimart.ai/v1` (включает `/v1`) * Не добавляйте лишние пути и не пропускайте `/v1` 2. **Проверьте API Key**: * Убедитесь, что API Key начинается с `sk-` * Проверьте действительность ключа в [консоли APIMart](https://apimart.ai/keys) 3. **Проверьте сетевое подключение**: * Убедитесь в доступности `https://api.apimart.ai` * Проверьте настройки брандмауэра или прокси ### Q2: Документы не извлекаются корректно после загрузки? **Решение:** 1. **Проверьте конфигурацию embedding-модели**: * Убедитесь, что embedding-модель настроена правильно * Протестируйте подключение embedding-модели 2. **Переобработайте документы**: * Удалите и перезагрузите документы * Проверьте, поддерживается ли формат документа 3. **Настройте параметры поиска**: * Настройте порог сходства в настройках рабочего пространства * Увеличьте количество возвращаемых фрагментов документов ### Q3: Медленный отклик диалога? **Решение:** 1. **Переключитесь на более быстрые модели**: * Используйте `gpt-4o-mini` вместо `gpt-4o` * Используйте `gemini-2.0-flash-exp` для более быстрого ответа 2. **Оптимизируйте количество документов**: * Уменьшите количество документов в рабочем пространстве * Удалите ненужные большие файлы 3. **Настройте Max Tokens**: * Уменьшите максимальную длину вывода * Используйте более лаконичные промпты ### Q4: Как просмотреть использование API и расходы? Войдите в [консоль APIMart](https://apimart.ai/overview), чтобы посмотреть: * 📊 Статистику вызовов API * 💰 Детали расходов * 📈 Графики тенденций использования * 🔍 Подробные логи запросов ### Q5: Какие варианты развёртывания поддерживает AnythingLLM? AnythingLLM поддерживает несколько вариантов развёртывания: * 🖥️ **Десктоп-приложение** — Windows, macOS, Linux * 🐳 **Docker** — самостоятельное развёртывание * ☁️ **Облачная версия** — AnythingLLM Cloud (скоро) ## Примеры сценариев использования ### 1. Корпоративная база знаний **Конфигурация:** * Модель: `gpt-4o-mini` (выгодная) * Документы: внутренние документы, руководства, FAQ * Функция: быстрый поиск информации для сотрудников **Примеры применения:** * Онбординг новых сотрудников * Быстрый поиск политик компании * Поиск в технической документации ### 2. Помощник по технической документации **Конфигурация:** * Модель: `claude-sonnet-4-5-20250929` (отлично для кода) * Документы: API-документы, технические спецификации, кодовая база * Функция: помощь разработчикам в поиске технической информации **Примеры применения:** * Запросы к документации по использованию API * Поиск примеров кода * Ответы на технические вопросы ### 3. База знаний клиентского сервиса **Конфигурация:** * Модель: `gpt-4o` (высококачественный диалог) * Документы: руководства по продукту, FAQ, решения * Функция: быстрый ответ на вопросы клиентов **Примеры применения:** * Автоматические ответы на FAQ * Руководство по использованию продукта * Советы по устранению неполадок ### 4. Помощник по исследованиям и обучению **Конфигурация:** * Модель: `gpt-5` (мощное понимание) * Документы: научные статьи, учебники, заметки * Функция: помощь в обучении и исследованиях **Примеры применения:** * Резюмирование и анализ статей * Объяснение концепций * Планирование образовательного пути ## Возможности Используя AnythingLLM + APIMart, вы можете: * 📚 **Приватная база знаний** — создавайте безопасную приватную базу знаний локально * 🔒 **Конфиденциальность данных** — все данные хранятся локально, защищая приватность * 🤖 **Поддержка нескольких моделей** — гибко переключайтесь между разными AI-моделями * 📄 **Поддержка нескольких форматов** — поддержка различных форматов документов * 🎯 **Точный поиск** — интеллектуальный поиск по документам на основе векторов * 💬 **Контекстный диалог** — поддержание контекста в длинных диалогах * 🔧 **Высокая настраиваемость** — настраиваемые промпты, параметры и т. д. * 🌐 **Кроссплатформенность** — поддержка Windows, macOS, Linux ## Безопасность данных и конфиденциальность ### Локальное хранение данных Подход AnythingLLM к хранению данных: * 📁 **Локальная файловая система** — документы хранятся локально * 🗄️ **Локальная векторная база** — векторные индексы хранятся локально * 💾 **История диалогов** — записи диалогов хранятся локально ### Безопасность API-вызовов * 🔐 **Шифрованная передача** — все API-вызовы используют HTTPS-шифрование * 🔑 **Защита ключа** — API Key хранится безопасно * 🚫 **Нет хранения данных** — APIMart не хранит содержимое ваших диалогов **Уведомление о конфиденциальности:** хотя документы хранятся локально, диалоги и извлечённый контент, отправляемый в ИИ, передаются на серверы APIMart через API для обработки. Избегайте загрузки или запросов с конфиденциальной информацией. ## Лучшие практики ### 1. Управление документами * **Регулярные обновления** — поддерживайте актуальность содержимого документов * **Структурированная организация** — используйте чёткую структуру папок * **Соглашения об именовании** — используйте осмысленные имена файлов * **Удаление устаревших** — регулярно удаляйте устаревшие документы ### 2. Оптимизация промптов **❌ Плохой промпт:** ``` You are an assistant ``` **✅ Хороший промпт:** ``` You are a professional technical support assistant specializing in helping users resolve product-related technical issues. When answering, please follow these principles: 1. Answer based on provided documentation; if information isn't available, clearly state so 2. Provide detailed step-by-step instructions with examples when necessary 3. Use clear, understandable language 4. For complex issues, recommend contacting the technical support team ``` ### 3. Оптимизация производительности * **Контролируйте размер документов** — избегайте загрузки слишком больших отдельных файлов * **Разумное разбиение** — используйте настройки разбиения по умолчанию * **Выбирайте подходящую модель** — выбор модели в зависимости от сложности задачи * **Мониторинг использования** — регулярно проверяйте использование API ### 4. Планирование рабочих пространств * **Делите по проектам** — создавайте независимые рабочие пространства для разных проектов * **Управление правами** — настраивайте права рабочих пространств (Docker-версия) * **Резервное копирование** — регулярно бэкапьте важные рабочие пространства ## Поддержка и помощь Если у вас возникнут проблемы: * 📚 [Документация APIMart](https://docs.apimart.ai) * 📚 [Официальная документация AnythingLLM](https://docs.anythingllm.com/) * 📚 [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) * 💬 [Сообщество Discord](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @APIMart\_](https://x.com/APIMart_) * 📧 Техническая поддержка: [zhihong@apimart.ai](mailto:zhihong@apimart.ai) *** Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и создайте свою приватную базу знаний в AnythingLLM!