> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Использование Ace Data Cloud в AnythingLLM

> Platform API guide - Ace Data Cloud

[AnythingLLM](https://anythingllm.com/) — это клиент с открытым исходным кодом, ориентированный на «документы → приватный ChatGPT», ключевая концепция которого — **Workspace**: каждый Workspace представляет собой набор документов, набор пользователей и набор инструментов Agent, изолированных независимо. Он специально разработан для диалогов с документами и доступен в виде настольного приложения и Docker. В **LLM Provider** он включает пункт [OpenAI (Generic)](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic), где можно указать пользовательский Base URL, поэтому модель диалога можно напрямую направить на Ace Data Cloud. В этой статье описан процесс настройки.

## Процесс подачи заявки

Чтобы подключить Ace Data Cloud в AnythingLLM, сначала перейдите в [консоль Ace Data Cloud](https://platform.acedata.cloud/console/applications), получите ваш API Token и сохраните его для дальнейшего использования.

![Получение Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

Если вы ещё не вошли в систему или не зарегистрировались, вы будете автоматически перенаправлены на страницу входа, где вам будет предложено зарегистрироваться и войти; после регистрации и входа вы автоматически вернётесь на текущую страницу.

При первой подаче заявки предоставляется бесплатная квота, позволяющая бесплатно опробовать модельные сервисы Ace Data Cloud.

## Загрузка AnythingLLM

Для личного использования можно скачать [настольную версию](https://anythingllm.com/download), векторная база данных (LanceDB) работает локально, поиск по документам полностью офлайн, подключение к сети требуется только при вызове модели; для командных многопользовательских сценариев используйте [развёртывание Docker](https://docs.anythingllm.com/installation-docker/overview).

## Настройка модели диалога

Запустите AnythingLLM, перейдите в **Settings → LLM Preference**, в качестве Provider выберите **OpenAI (Generic)** (не выбирайте обычный OpenAI, он фиксированно указывает на `api.openai.com` и не имеет пользовательского Base URL). Официальная документация: [OpenAI (Generic) LLM Provider](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic).

| Поле | Значение | Описание |
| - | - | - |
| Base URL | `https://api.acedata.cloud/v1` | **должен оканчиваться на `/v1`** |
| API Key | ваш Ace Data Cloud Token | Token, скопированный из консоли |
| Selected Model | ID текущей модели | В первую очередь используйте список, автоматически загружаемый из `/models`; если он не возвращается, запросите его указанным выше способом и заполните вручную |
| Model context window | укажите в соответствии с выбранной моделью | Считайте верхний предел контекста из текущего каталога моделей, не копируйте значения других моделей |

![Интерфейс настройки AnythingLLM Generic OpenAI](https://cdn.acedata.cloud/a155f5476de7.png)

> Возможности модели и верхний предел контекста определяются текущим каталогом моделей.

Обратите внимание на правила пути Base URL:

| Base URL | Фактический запрос | Результат |
| - | - | - |
| `https://api.acedata.cloud/v1` | `https://api.acedata.cloud/v1/chat/completions` | Правильно |
| `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/chat/completions` | Также можно использовать |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (под `/openai` нет `/v1`) |
| `https://api.acedata.cloud` | `https://api.acedata.cloud/chat/completions` | 404 (отсутствует `/v1`) |

## Настройка модели Embedding

Основой AnythingLLM является RAG, для векторизации документов требуется модель эмбеддингов. Его **Embedding Preference** и LLM Preference — это две независимые конфигурации — см. [обзор настройки Embedder](https://docs.anythingllm.com/setup/embedder-configuration/overview). Встроенный **AnythingLLM Embedder（Built-in / Native）** работает напрямую локально, готов к использованию из коробки и не требует настройки, это выбор по умолчанию и рекомендуемый вариант:

Перейдите в **Settings → Embedding Preference**, оставьте Provider по умолчанию — **AnythingLLM Embedder**, никаких ключей заполнять не нужно. Он завершит векторизацию документов локально, а исходный текст и векторы будут храниться в локальной LanceDB, без загрузки в облако.

> Варианты Embedder в AnythingLLM (облачные: OpenAI / Azure OpenAI / Cohere; локальные: Built-in, LM Studio, [LocalAI](https://docs.anythingllm.com/setup/embedder-configuration/local/localai), Ollama) подключаются в своих фиксированных формах. Среди них облачные OpenAI embeddings фиксированно указывают на `api.openai.com` и не поддерживают пользовательский Base URL; если вы хотите использовать пользовательский endpoint, можно использовать **Generic OpenAI** Embedder (также имеет поле Base URL и может быть направлен на `text-embedding-3-large` Ace Data Cloud) или локальный **LocalAI** Embedder. В этой статье модель диалога использует Ace Data Cloud, а для эмбеддингов применяется встроенный локальный Embedder AnythingLLM, они не влияют друг на друга.

## Выбор модели

Каталог моделей будет постоянно обновляться. В первую очередь используйте список моделей, автоматически загружаемый клиентом; если требуется ручной ввод, сначала выполните запрос `GET https://api.acedata.cloud/v1/models`, чтобы получить текущий ID модели, затем выберите в соответствии с поддерживаемыми клиентом возможностями контекста, изображений и вызова инструментов.

## Проверка подключения

Если вы не уверены, связана ли проблема с AnythingLLM или сетью, можно сначала напрямую проверить endpoint с помощью curl (замените `{token}` на ваш Token):

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

Возврат объекта `chat.completion`, совместимого с OpenAI, означает, что Token и endpoint готовы; если возвращается `HTTP 403 used_up`, это означает, что Token действителен, но баланс недостаточен — пополните его в [консоли](https://platform.acedata.cloud/console/applications).

## Расширенно: Workspace и диалог с документами

После создания нового Workspace загрузите PDF / Word / Markdown и другие документы, AnythingLLM разделит их на абзацы, сгенерирует векторы с помощью локального Embedder и сохранит их в локальной LanceDB. Во время диалога он сначала извлечёт соответствующие фрагменты, затем передаст фрагменты вместе с вашим вопросом модели диалога (то есть Ace Data Cloud) для ответа и укажет источники цитирования под ответом. В верхней части каждого Workspace можно переключаться между режимами **Query** (ответы только на основе документов) и **Chat** (смешанные общие знания), для серьёзных сценариев рекомендуется использовать режим Query, чтобы избежать галлюцинаций. При развёртывании Docker можно использовать переменные окружения `GENERIC_OPEN_AI_BASE_PATH`, `GENERIC_OPEN_AI_API_KEY`, `GENERIC_OPEN_AI_MODEL_PREF` и другие, чтобы предварительно настроить такое же подключение модели диалога и включить многопользовательский режим.

## Часто задаваемые вопросы

### Появляется 404 / connection fail

Обычно Base URL указан как `.../openai/v1` или отсутствует `/v1`. Измените его на `https://api.acedata.cloud/v1`.

### Невозможно вести диалог после загрузки документа

Убедитесь, что в **Settings → Embedding Preference** выбран доступный Embedder (стандартный AnythingLLM Embedder может работать локально и не требует дополнительной настройки), затем повторно загрузите документ для генерации векторов.

### Появляется 401 Unauthorized

Пожалуйста, убедитесь, что в API Key вставлен Token Ace Data Cloud (без префикса `Bearer`, без лишних пробелов), и что у соответствующего приложения достаточно баланса.

### Будут ли локальные документы загружаться в облако

Нет. Исходный текст документов хранится в локальной LanceDB, модели будут отправлены только фрагменты, найденные при поиске, и ваш вопрос.

## Подробнее

* [Официальный сайт AnythingLLM](https://anythingllm.com/) ｜ [AnythingLLM GitHub](https://github.com/Mintplex-Labs/anything-llm) ｜ [Документация по развёртыванию Docker](https://docs.anythingllm.com/installation-docker/overview)
* [Документация AnythingLLM по LLM Provider OpenAI (Generic)](https://docs.anythingllm.com/setup/llm-configuration/cloud/openai-generic)
* [Обзор конфигурации Embedder в AnythingLLM](https://docs.anythingllm.com/setup/embedder-configuration/overview)
* [Документация Ace Data Cloud OpenAI Chat Completions API](https://platform.acedata.cloud/documents/openai-chat-completions)
* [Список сервисов Ace Data Cloud](https://platform.acedata.cloud/documents)
* [Консоль Ace Data Cloud](https://platform.acedata.cloud/console)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.