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

Раздел описывает все справочники конфигурации 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/ai-platforma-oneapa/spravochniki.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.