# Разработка агентов

Руководство по созданию ИИ агентов в OneAPA.

## Содержание раздела

| Страница                                                                                  | Описание                |
| ----------------------------------------------------------------------------------------- | ----------------------- |
| [Основы разработки](/ai-platforma-oneapa/razrabotka-agentov/osnovy-razrabotki.md)         | Базовые принципы        |
| [Создание инструментов](/ai-platforma-oneapa/razrabotka-agentov/sozdanie-instrumentov.md) | Разработка инструментов |
| [Работа с промптами](/ai-platforma-oneapa/razrabotka-agentov/rabota-s-promptami.md)       | Эффективные промпты     |
| [Настройка триггеров](/ai-platforma-oneapa/razrabotka-agentov/nastrojka-triggerov.md)     | События запуска         |
| [Лучшие практики](/ai-platforma-oneapa/razrabotka-agentov/luchshie-praktiki.md)           | Рекомендации            |
| [Примеры агентов](broken://pages/CJ9yzUSQRFkfvGB4Spfm)                                    | Готовые шаблоны         |

## Жизненный цикл агента

```
┌─────────────────────────────────────────────────────────────────────────┐
│                     ЖИЗНЕННЫЙ ЦИКЛ АГЕНТА                                │
│                                                                          │
│  1. ПЛАНИРОВАНИЕ                                                         │
│     └── Определение задач                                               │
│     └── Выбор модели                                                    │
│     └── Проектирование инструментов                                     │
│                           │                                              │
│                           ▼                                              │
│  2. РАЗРАБОТКА                                                           │
│     └── Написание промптов                                              │
│     └── Создание инструментов                                           │
│     └── Настройка триггеров                                             │
│                           │                                              │
│                           ▼                                              │
│  3. ТЕСТИРОВАНИЕ                                                         │
│     └── Проверка в чате                                                 │
│     └── Тестовые сценарии                                               │
│     └── Оценка качества                                                 │
│                           │                                              │
│                           ▼                                              │
│  4. РАЗВЁРТЫВАНИЕ                                                        │
│     └── Синхронизация с Proxy                                           │
│     └── Настройка доступа                                               │
│     └── Обучение пользователей                                          │
│                           │                                              │
│                           ▼                                              │
│  5. ЭКСПЛУАТАЦИЯ                                                         │
│     └── Мониторинг                                                      │
│     └── Сбор обратной связи                                             │
│     └── Улучшение                                                       │
└─────────────────────────────────────────────────────────────────────────┘
```

## Компоненты агента

| Компонент            | Описание              | Обязательный      |
| -------------------- | --------------------- | ----------------- |
| **Модель**           | LLM для обработки     | Да                |
| **Системный промпт** | Инструкция для агента | Да                |
| **Описание**         | Для автовыбора агента | Рекомендуется     |
| **Инструменты**      | Доступные функции     | Зависит от задачи |
| **Триггер**          | Событие запуска       | Рекомендуется     |
| **Пользователи**     | Ограничение доступа   | Опционально       |

## Быстрый старт

### Минимальный агент

```
1. Создайте модель (OpenAI GPT-4o)
2. Создайте агента:
   - Наименование: Помощник
   - Модель: OpenAI GPT-4o
   - Системный промпт: "Ты — помощник. Отвечай кратко."
3. Синхронизируйте с Proxy
4. Тестируйте в чате
```

### Агент с инструментом

```
1. Создайте инструмент:
   - Наименование: Текущая дата
   - Код: Результат = Строка(ТекущаяДата());
   
2. Добавьте инструмент в агента
3. Синхронизируйте
4. Спросите: "Какое сегодня число?"
```

## Рекомендации

### Начните просто

1. Один агент — одна задача
2. Минимум инструментов
3. Чёткий промпт

### Тестируйте итеративно

1. Проверяйте каждое изменение
2. Собирайте обратную связь
3. Улучшайте постепенно

### Документируйте

1. Описывайте назначение
2. Фиксируйте изменения
3. Обучайте пользователей

## Далее

{% content-ref url="/pages/i5MMRENRTtDJp0PTee2F" %}
[Основы разработки](/ai-platforma-oneapa/razrabotka-agentov/osnovy-razrabotki.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/razrabotka-agentov.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.