> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/spravochniki.md).

# Справочники

Раздел описывает все справочники конфигурации OneAPA.

## Список справочников

| Справочник                                                       | Назначение                   | Иерархический |
| ---------------------------------------------------------------- | ---------------------------- | ------------- |
| [Пользователи](/ai-platforma-oneapa/spravochniki/polzovateli.md) | Учёт пользователей системы   | Нет           |
| [Агенты](/ai-platforma-oneapa/spravochniki/agenty.md)            | Основная сущность ИИ агентов | Да            |
| [Инструменты](/ai-platforma-oneapa/spravochniki/instrumenty.md)  | Инструменты для агентов      | Да            |
| [Модели](/ai-platforma-oneapa/spravochniki/modeli.md)            | Конфигурация LLM провайдеров | Нет           |
| [Триггеры](/ai-platforma-oneapa/spravochniki/triggery.md)        | События запуска агентов      | Нет           |
| [Форматы](/ai-platforma-oneapa/spravochniki/formaty.md)          | Форматы выходных данных      | Нет           |
| [MCP серверы](/ai-platforma-oneapa/spravochniki/mcp-servery.md)  | Внешние MCP серверы          | Да            |

## Схема взаимосвязей

```
┌─────────────────────────────────────────────────────────────────────────┐
│                        ВЗАИМОСВЯЗИ СПРАВОЧНИКОВ                          │
│                                                                          │
│                         ┌─────────────────┐                             │
│                         │    АГЕНТЫ       │                             │
│                         │                 │                             │
│                         │ • Модель ────────┼──────► Модели              │
│                         │ • Триггер ───────┼──────► Триггеры            │
│                         │ • СледующийАгент│                             │
│                         └────────┬────────┘                             │
│                                  │                                       │
│              ┌───────────────────┼───────────────────┐                  │
│              │                   │                   │                  │
│              ▼                   ▼                   ▼                  │
│     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐            │
│     │ Инструменты │     │ Пользователи│     │ MCP серверы │            │
│     │             │     │             │     │             │            │
│     │ • Формат ───┼────►│ Форматы     │     │             │            │
│     └─────────────┘     └─────────────┘     └─────────────┘            │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

## Ключевые справочники

### Агенты

**Центральный справочник системы.** Определяет:

* Какую модель использует агент
* Какой системный промпт применять
* Какие инструменты доступны
* Кто может использовать агента
* При каком событии агент активируется

### Инструменты

**Функциональные возможности агентов.** Определяет:

* Что агент может делать
* Какие параметры принимает инструмент
* Какой код выполняется
* Кто может использовать инструмент

### Модели

**Подключение к LLM.** Определяет:

* Какой провайдер используется
* Параметры подключения (ключи, URL)
* Какая конкретная модель

## Общие принципы работы

### Создание элемента

1. Откройте справочник
2. Нажмите "Создать"
3. Заполните обязательные поля
4. Сохраните

### Иерархические справочники

Справочники Агенты, Инструменты и MCP серверы поддерживают иерархию (группы):

```
📁 Агенты
├── 📁 Финансовые
│   ├── Бухгалтер
│   └── Финансовый аналитик
├── 📁 HR
│   ├── Кадровик
│   └── Рекрутер
└── 📁 Поддержка
    ├── Первая линия
    └── Техническая поддержка
```

### Синхронизация с Proxy

{% hint style="warning" %}
После изменения справочников выполните команду "Выполнить обмен с Proxy" для синхронизации данных.
{% endhint %}

## Далее

Начните с изучения основного справочника:

{% content-ref url="/pages/opynIs0ONncXeDwZZnB6" %}
[Агенты](/ai-platforma-oneapa/spravochniki/agenty.md)
{% endcontent-ref %}