cosai · Документация
Начало работы

Ключевые понятия

Тенант, база знаний, агент, скилл, eval-гейт, контур данных — на одной странице.

На этой странице — основные понятия платформы одним экраном. К ней удобно возвращаться, когда встречается незнакомый термин в других разделах.

Организация

Организация (тенант) — это ваша компания на платформе. У неё свой набор баз знаний, агентов, скиллов и статистики использования, полностью изолированный от других организаций. Вход в консоль — по API-ключу организации.

База знаний

База знаний — это набор загруженных документов (PDF, DOCX, TXT, Markdown), на которых агенты строят ответы. Документы автоматически разбираются, режутся на фрагменты (чанки) и индексируются, чтобы агент мог быстро найти нужный кусок текста и сослаться на него. Подробнее — в разделе Базы знаний.

Агент

Агент — это работающий помощник, который отвечает клиентам или сотрудникам. Он собирается из четырёх частей:

  • Персона — кто агент и как он говорит (роль, тон общения, системная инструкция).
  • Скиллы — переиспользуемые блоки компетенций, например «работа с возражениями» или «подбор аналога».
  • Базы знаний — какие именно базы агент видит (можно дать доступ ко всем базам организации или только к части).
  • Модель — какая генеративная LLM отвечает от имени агента.

Подробнее — в разделе Модель агента.

Скилл

Скилл — переиспользуемый блок правил поведения, который можно навесить на любого агента: как отрабатывать возражения, как подбирать аналог товара, как квалифицировать клиента, когда эскалировать на человека. Платформа поставляет готовые шаблоны, но можно создавать и свои. Подробнее — в разделе Скиллы.

Eval-гейт

Eval-гейт — автоматическая проверка качества, через которую агент обязан пройти перед публикацией. Платформа задаёт агенту контрольные вопросы (обычные, пограничные и вопросы не по теме) и оценивает, опирается ли он на базу знаний, ставит ли ссылки на источники и честно ли отказывает, если ответа нет. Порог прохождения — 85% вопросов. Подробнее — в разделе Качество и публикация.

Контур данных

Контур — это периметр обработки данных организации: rf (данные и запросы к LLM остаются в периметре, доступны только российские модели — YandexGPT, GigaChat) или global (доступны и зарубежные модели — Anthropic, OpenAI, DeepSeek и другие). Контур закреплён за организацией, и агент организации в контуре rf физически не может обратиться к модели контура global. Подробнее — в разделе Контуры данных rf/global.

Каналы внедрения

Готового (опубликованного) агента можно подключить тремя способами: чат-виджет на сайт без кода, REST API для своей интеграции, MCP для подключения из AI-клиентов.

On this page