Карта по AI-клиентам для скриптов

Справочная карта для script mini-apps, которым нужен AI chat, vision, tool-calling или agent workflows. Начинайте со встроенного runtime EyeAuras.AI, добавляйте EyeAuras.AI.Desktop для desktop-интеграций, а прямые NuGet-клиенты провайдеров используйте только как явный escape hatch.

Что обычно нужно

• Вызвать внешний chat/vision/OCR model из скрипта.
• Отправить захваченное изображение в AI model.
• Использовать OpenAI .NET client или клиент другого провайдера.
• Понять, что выбрать — встроенный рантайм EyeAuras AI или прямые вызовы через NuGet API.
• По возможности хранить API keys и конфигурацию моделей вне захардкоженного исходника.

Как это устроено

• EyeAuras.AI — пакет с non-desktop runtime-поверхностью EyeAuras AI.
• EyeAuras.AI.Desktop — desktop AI helpers поверх EyeAuras.AI.
• EyeAuras.AISdk — compatibility/legacy surface для проектов, которые всё ещё ожидают старую объединённую форму AI SDK.
• Встроенный рантайм EyeAuras AI — это подсистема приложения для chat sessions, profiles, retrieval, plugins и tool approval.
• Внешние AI-клиенты из NuGet — это обычные зависимости скрипта, которые mini-app использует напрямую.
• Прямые клиенты чаще всего проще для разовых OCR/vision/chat-вызовов.
• Встроенный рантайм лучше подходит для интегрированного chat UI, retrieval, tool plugins, profiles и долгоживущих AI-сценариев.
• Захваченные изображения экрана или окна обычно приходят из CV/image API, а затем конвертируются в формат изображения, который поддерживает конкретный провайдер.

Типовой сценарий: встроенный AI runtime

1. Подключить EyeAuras.AI для non-desktop AI-интеграций или EyeAuras.AI.Desktop, если проекту нужны desktop UI/helpers.
2. Получить AI-сервисы через host script/project surface: обычно AiEngine, IAiProfileRepository, session configurators или UI factories.
3. Создать IAiSession / IAiChatSession через AiEngine.
4. Настроить profile, tools, retrieval и approval policy.
5. Использовать session из script, Razor UI, tool window или app service.

Типовой сценарий: захватить изображение и спросить AI

1. Захватить изображение или получить его из CV/window/image API.
2. Конвертировать его в bytes или stream-формат, который поддерживает провайдер.
3. Создать и настроить внешний AI client.
4. Собрать chat/vision request с текстом и содержимым изображения.
5. Отправить запрос.
6. Разобрать, сохранить или показать полученный текст.
7. Освободить subscriptions/resources в соответствии со временем жизни скрипта.

Что предпочесть

• Используйте встроенный runtime EyeAuras.AI / EyeAuras.AI.Desktop, если нужен AI-помощник, встроенный в приложение, model profiles, retrieval, scenarios с tools/plugins, MCP/Codex или переиспользуемый chat UI.
• Используйте прямые provider NuGet-пакеты для небольших автономных вызовов.
• Храните API keys в variables, config providers, user settings или secret storage, а не хардкодьте их в исходнике.
• Для vision-вызовов предпочитайте ограниченные размеры изображений и сжатые форматы.
• Лучше разделять логику захвата изображения и логику AI-запроса через клиент.

Чего избегать

• Не путайте внешние provider SDK с runtime-сервисами EyeAuras.AI, EyeAuras.AI.Desktop или compatibility-пакетом EyeAuras.AISdk.
• Не хардкодьте реальные API keys в скриптах и документации.
• Не отправляйте большие raw images, если достаточно сжатых bytes.
• Не блокируйте UI/render loops, пока ждёте сетевой ответ.
• Не рассчитывайте на то, что версии provider SDK и имена моделей всегда останутся актуальными.

Ключевые сущности для поиска

• EyeAuras.AI
• EyeAuras.AI.Desktop
• EyeAuras.AISdk
• AiEngine
• IAiChatSession
• AiModelProfile
• AiKernelPlugin
• OpenAIClient
• OpenAI.Chat
• ChatClient
• ChatMessage
• ChatMessageContentPart
• BinaryData
• ToJpegData
• IImageSearchTrigger
• WindowImageProcessedEventArgs

Синонимы для поиска

• external AI client
• OpenAI NuGet
• chat client
• vision model
• GPT OCR
• image to text
• screenshot OCR
• direct provider SDK
• built-in AI runtime
• AI profile
• AI plugin

Смежные карты

• ml/ai.md
• ml/ai-runtime.md
• ml/ai-kernel-plugins.md
• computer-vision/images.md
• scripting/references-and-resources.md