🤖 A1sAI — Работа с AI-сервисами

🎯 Основные возможности

🌐 Поддерживаемые платформы

📖 Примеры использования

1. Простой запрос

A1sAI.OpenChatGPT("Как работает ООП в Python?");

2. Запрос с обогащениями

A1sAI.OpenChatGPT(
    "Как использовать классы в Python для управления данными?",
    "РОЛЬ: Ты — эксперт по Python с 10-летним стажем.",
    "ОПРЕДЕЛЕНИЯ: 1. Класс — шаблон объекта. 2. Инкапсуляция — скрытие деталей реализации.",
    "ФОРМАТ ОТВЕТА: Приведи пример кода с пояснением."
);

3. Универсальная функция с выбором платформы

// Запрос в ChatGPT (по умолчанию)
A1sAI.Open("Сравни подходы к ООП в Python и JavaScript");

// Запрос в Perplexity
A1sAI.Open("Какие новые библиотеки Python появились в 2025?", "perplexity");

// Запрос в Claude с обогащениями
A1sAI.Open(
    "Сравни подходы к ООП",
    "claude",
    "РОЛЬ: Технический эксперт по программированию.",
    "СТИЛЬ: Технический, с примерами кода."
);

4. Случайная платформа

// Откроет случайную AI-платформу для экспериментов
A1sAI.Open("Объясни квантовые вычисления простыми словами", "random");

5. Использование алиасов

// Эти варианты эквивалентны:
A1sAI.Open("Вопрос", "chatgpt");
A1sAI.Open("Вопрос", "gpt");
A1sAI.Open("Вопрос", "oai");

// Для Perplexity:
A1sAI.Open("Вопрос", "perplexity");
A1sAI.Open("Вопрос", "pplx");

🎨 Обогащение промптов (8 параметров)

Все функции A1sAI поддерживают до 8 необязательных параметров обогащения, которые добавляются в начало промпта:

A1sAI.OpenChatGPT(
    "Напиши REST API на Flask",
    "РОЛЬ: Senior Python Developer",
    "СТИЛЬ: Производственный код с комментариями",
    "ТЕХНОЛОГИИ: Flask, SQLAlchemy, JWT",
    "ТРЕБОВАНИЯ: RESTful принципы, обработка ошибок",
    "ФОРМАТ: Полный рабочий пример",
    "БЕЗОПАСНОСТЬ: Включить валидацию и авторизацию",
    "ДОКУМЕНТАЦИЯ: Добавить docstrings",
    "ТЕСТИРОВАНИЕ: Примеры unit-тестов"
);

📚 Все функции модуля

Основные экспортные функции:

Служебные функции:

• URLEncode(Текст) — кодирование строки для URL
• NormalizePlatformName(Name) — нормализация имени платформы и алиасов
• BuildURL(PlatformName, EncodedQuery) — построение URL
• СформироватьОбогащенныйПромпт() — формирование промпта с обогащениями
• PickRandomPlatform() — выбор случайной платформы

🚀 Практические сценарии

Процедура ПолучитьПомощьПоКоду() Экспорт
    ФрагментКода = "Запрос.УстановитьПараметр(...)";
    
    A1sAI.Open(
        "Объясни этот код 1С: " + ФрагментКода,
        "chatgpt",
        "РОЛЬ: Эксперт по 1С:Предприятие 8.3",
        "КОНТЕКСТ: Объясни для junior-разработчика",
        "ФОРМАТ: Пошаговое объяснение + пример использования"
    );
КонецПроцедуры

Процедура НайтиРешениеОшибки(ТекстОшибки) Экспорт
    A1sAI.OpenPerplexity(
        "Как исправить ошибку в 1С: " + ТекстОшибки,
        "КОНТЕКСТ: 1С:Предприятие 8.3, управляемые формы",
        "ФОРМАТ: Причина ошибки + решение с кодом"
    );
КонецПроцедуры

Процедура СгенерироватьЗапрос(Описание) Экспорт
    A1sAI.Open(
        Описание,
        "claude",
        "РОЛЬ: Эксперт по языку запросов 1С",
        "ЗАДАЧА: Создай SQL запрос для 1С:Предприятие",
        "ФОРМАТ: Готовый код запроса + комментарии",
        "ТРЕБОВАНИЯ: Использовать виртуальные таблицы где возможно"
    );
КонецПроцедуры

Процедура СравнитьОтветыAI(Вопрос) Экспорт
    // Спросим у разных AI один и тот же вопрос
    МассивПлатформ = A1sAI.ListPlatforms();
    
    Для Каждого Платформа Из МассивПлатформ Цикл
        A1sAI.Open(Вопрос, Платформа);
        // Пауза между открытиями вкладок
        ОбработкаПрерыванияПользователя();
    КонецЦикла;
КонецПроцедуры

⚙️ Технические детали

Формат обогащенного промпта:

// Исходный вызов:
A1sAI.Open(
    "Основной вопрос",
    "chatgpt",
    "Обогащение 1",
    "Обогащение 2"
);

// Результирующий промпт в ChatGPT:
/*
Обогащение 1

Обогащение 2

Основной вопрос
*/

URL-кодирование:

Модуль автоматически кодирует специальные символы для безопасной передачи в URL:

• Пробелы → %20
• Знаки вопроса → %3F
• Амперсанды → %26
• И другие специальные символы

Поддержка флагов:

Модуль работает на: Server + External connection + Client

✅ Тестирование

Модуль включает полный набор юнит-тестов:

// Запуск самотестирования
Если A1sAI.SelfTest() Тогда
    Сообщить("✅ Все тесты A1sAI пройдены!");
Иначе
    Сообщить("❌ Обнаружены ошибки в A1sAI");
КонецЕсли;

📥 Установка и использование

1. Скачайте модуль:

Скачать A1sAI.bsl

2. Подключите зависимости:

• A1sS — для вывода сообщений (A1sS.Print, A1sS.PrintYN)
• A1sO — для работы с коллекциями (A1sO.Ключи)

3. Добавьте модуль в конфигурацию:

• Создайте общий модуль A1sAI
• Установите флаги: Server ✓, External connection ✓, Client ✓
• Скопируйте код из A1sAI.bsl

4. Начните использовать:

A1sAI.OpenChatGPT("Привет, ChatGPT!");

🎯 Быстрый старт

// 1. Простой запрос
A1sAI.OpenChatGPT("Как работает ООП?");

// 2. С обогащениями
A1sAI.Open(
    "Напиши функцию сортировки",
    "chatgpt",
    "РОЛЬ: Программист 1С",
    "ЯЗЫК: 1С:Предприятие 8.3"
);

// 3. Случайная платформа
A1sAI.Open("Объясни REST API", "random");

🐱 Совет от кота Айвана: Экспериментируй с обогащениями — они помогают получить более точные и полезные ответы от AI!

🔗 Полезные ссылки

• Главная страница A1sCode
• Библиотека модулей
• Стандарты оформления кода
• Скачать A1sAI.bsl