TeleThinker

Тема

TeleThinker Wiki ​

Добро пожаловать в документацию платформы TeleThinker — персонального AI-агента на базе LLM с планированием и выполнением действий.

О платформе ​

TeleThinker — это микросервисная платформа, которая сочетает реактивное мышление ReAct и STRIPS-подобное планирование. Платформа принимает цели от пользователя, строит пошаговый план с учетом предусловий действий и последовательно исполняет его, взаимодействуя с внутренними сервисами и внешними системами.

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

  • 🧠 Интеллектуальное планирование на основе STRIPS-алгоритма, усиленного LLM
  • 💬 Многоканальное взаимодействие (Telegram, веб-интерфейс, API)
  • 📚 Управление знаниями через RAG-систему
  • 🔧 Расширяемость через динамическое подключение действий
  • ⚡ Микросервисная архитектура

См. также: Обзор сервисов — список всех сервисов платформы

Примечание о портах. Порты в карточках сервисов ниже — это внутренние порты контейнеров (из config/*.yaml, Dockerfile и docker-compose.yml). Наружу они напрямую не публикуются: внешний доступ идёт через Traefik по доменам *.localhost (HTTP-вход localhost:3042, дашборд Traefik — localhost:8080). Порт The Machine — 5242 (ранее в документации ошибочно указывался 8080; 8080 занят дашбордом Traefik). Подробности и связанные расхождения см. в The Machine.

Сущности (Entities) ​

Документация по ключевым сущностям и концепциям системы.

Действия (Actions) ​

Центральная сущность системы — атомарные операции, которые может выполнить AI-агент. Описание структуры действий, их типов, предусловий, эффектов и параметров. Используется сервисами PLAN и ACT для планирования и выполнения.

Связанные документы:

  • Action Registry — сервис хранения и управления действиями
  • Think Schemas — типизированные схемы для описания действий

Think Schemas ​

Go-модуль для стандартизированного описания и валидации схем данных. Единый источник правды для моделей, описывающих состояние мира, предусловия, эффекты и параметры действий.

Связанные документы:

  • Действия — использование think-schemas в действиях
  • Action Registry — интеграция с сервисом хранения действий

Промпты (Prompts) ​

Шаблоны промптов для LLM в формате Markdown с YAML front matter. Содержат метаданные (модель, температура, structured_output) и текст промпта с плейсхолдерами. Хранятся в базе промптов LLM Adapter и используются для выполнения различных задач.

Связанные документы:

Основные сервисы (Core Services) ​

Центральные сервисы платформы, отвечающие за планирование и выполнение задач.

The Machine (Оркестратор) ​

Статус: active | Путь: src/the-machine | Порт: 5242

Центральный координирующий сервис в архитектуре TeleThinker Engine. Управляет жизненным циклом задач, принимая цели от пользователя и координируя взаимодействие между планировщиком и исполнителем для их достижения.

Связанные документы:

STRIPS Planner (Планировщик) ​

Статус: active | Путь: src/strips-planner | Порт: 5342

Ключевой компонент, отвечающий за интеллектуальное планирование. Использует STRIPS-подобный алгоритм, усиленный возможностями LLM и RAG, для построения последовательности действий (плана), необходимых для достижения поставленной цели.

Связанные документы:

  • Action Registry — получение метаданных действий
  • LLM Adapter — использование LLM для планирования
  • RAG Retriever — поиск информации для планирования

Action Runner (Исполнитель) ​

Статус: active | Путь: src/action-runner | Порт: 5742

Исполнительный компонент системы. Получает конкретное действие от Оркестратора, запрашивает его детали в Реестре Действий и выполняет его, взаимодействуя с адаптерами (LLM, RAG, Chat).

Связанные документы:

Сервисы данных (Data Services) ​

Сервисы для хранения и управления данными системы.

Action Registry (Реестр Действий) ​

Статус: active | Путь: src/action-registry | Порт: 5542

Сервис хранения, управления и предоставления информации о Действиях. Центральный реестр всех возможностей AI-агента. Предоставляет планировщику и исполнителю метаданные и технические детали, необходимые для планирования и выполнения каждого действия.

Связанные документы:

Context Store ​

Статус: active | Путь: src/context-store | Порт: 8081 (код-дефолт 8080 — см. страницу сервиса)

Сервис для хранения контекста и истории диалогов. Позволяет агенту получать историю переписки для формирования более точных и релевантных ответов.

Связанные документы:

  • The Machine — использование контекста в оркестрации

Адаптеры (Adapters) ​

Сервисы для взаимодействия с внешними системами и API.

LLM Adapter ​

Статус: active | Путь: src/llm-adapter | Порт: 5042

API-адаптер для взаимодействия с большими языковыми моделями (например, Gemini). Предоставляет унифицированный интерфейс для выполнения таких задач, как генерация текста, ведение диалога и использование промпт-шаблонов.

Связанные документы:

RAG Retriever ​

Статус: active | Путь: src/llm-rag | Порт: 5142

Сервис поиска и извлечения информации (Retrieval-Augmented Generation). Используется планировщиком и другими компонентами для получения релевантной информации из базы знаний (Markdown-файлов) с целью обогащения контекста при принятии решений.

Связанные документы:

  • STRIPS Planner — использование RAG в планировании
  • Action Runner — использование RAG при выполнении

Telegram Chat Adapter ​

Статус: active | Путь: src/tg-chat

Адаптер для взаимодействия с Telegram. Служит одним из пользовательских интерфейсов для AI-агента, принимая сообщения от пользователей и отправляя им ответы, сгенерированные системой.

Связанные документы:

  • The Machine — обработка запросов от пользователей

Интеграционные сервисы (Integration Services) ​

Сервисы для расширения и интеграции с внешними системами.

MCP Discovery ​

Статус: не реализован (планируется) | Путь: src/mcp-discovery | Порт: 5842 (проектный, см. TODO на странице)

Интеграционный сервис для динамического расширения возможностей системы. Обнаруживает внешние сервисы, совместимые с Meta-Channel Protocol (MCP), и автоматически регистрирует их возможности в качестве новых "базовых действий" в Action Registry.

Связанные документы:

Клиентские библиотеки (Client Libraries) ​

SDK и библиотеки для взаимодействия с сервисами платформы.

LLM Adapter Client ​

Статус: active | Путь: src/llm-adapter-client

Клиентский SDK для взаимодействия с LLM Adapter. Предоставляет унифицированный интерфейс для выполнения таких задач, как генерация текста, ведение диалога и использование промпт-шаблонов.

Связанные документы:

Инструменты управления (Management Tools) ​

Инструменты для управления и мониторинга платформы.

Action Manager (UI) ​

Статус: active | Путь: src/action-manager

Фронтенд-приложение на Vue.js для управления AI-агентом. Предоставляет администраторам и разработчикам пользовательский интерфейс для настройки, мониторинга и управления всеми компонентами системы.

Связанные документы:

  • Action Registry — управление действиями через UI

TeleThinker Manager (CLI) ​

Статус: active (CLI-утилита, вне рантайм-стека) | Путь: src/telethinker-cli

CLI-утилита на Golang для управления конфигурацией и жизненным циклом всей платформы TeleThinker. Позволяет инициализировать, настраивать, проверять и запускать микросервисы экосистемы.

Модули (Modules) ​

Переиспользуемые модули и библиотеки платформы.

Think Schemas ​

Статус: active | Путь: src/think-schemas

Go-модуль для стандартизированного описания и валидации схем данных в системе TeleThinker Engine. Единый источник правды для моделей, описывающих состояние мира, предусловия, эффекты и параметры действий.

Связанные документы:

Дополнительные материалы ​

Оркестрация ​

Общий процесс оркестрации задач в системе TeleThinker. Описание цикла Thought → Plan → Act и взаимодействия между компонентами.

Связанные документы:

Effect Builder ​

Механизм построения эффектов действий на основе декларативных правил EffectsSpec.

Связанные документы:

WFC (Wave Function Collapse) ​

Алгоритм Wave Function Collapse, используемый в системе для решения задач планирования.

Быстрая навигация ​

По ролям ​

По компонентам ​

Версия документа: 1.1
Последнее обновление: 2026-06-21
Статус: Актуально ✅ (все страницы сервисов созданы; открытые развилки помечены TODO в соответствующих страницах)

Документация платформы TeleThinker

TeleThinker