vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-29 02:33:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
agent-zero/plugins/_telegram_integration/AGENTS.md
frdel 15a2b553be Unify global model presets 
Make model presets a single global collection and treat presets as reusable setups (main, utility, embedding). Persisted scope configs now store only a preset name (Default is always present and immutable); project-scoped preset definitions were removed and attempts to edit/reset project presets are rejected. Add embedding-model support throughout: include embedding slot in presets, surface embedding in the switcher and override APIs, and notify extensions when the effective embedding model changes. Implement rename/retire propagation to update plugin configs, saved chats, and live AgentContext objects when preset names change or presets are removed. Update CLI/integration commands to use an "inherit" action for returning to the scoped preset and to report the effective scoped-or-chat preset. Add startup migration/bootstrap to initialize presets from remote or bundled fallback and numerous docs/UI text updates to reflect the new preset model. Extra: refactor config resolution helpers and add safety checks (validation, atomic writes) when saving presets.
2026-07-17 12:16:10 +02:00

1.4 KiB
Raw Permalink Blame History

Telegram Integration Plugin DOX

Purpose

  • Own Telegram bot integration for Agent Zero with polling, webhook, per-user sessions, and file exchange.

Ownership

  • helpers/bot_manager.py owns bot lifecycle.
  • helpers/handler.py and helpers/telegram_client.py own message routing, replies, and Telegram API interaction.
  • helpers/dependencies.py and requirements.txt own framework-runtime dependency bootstrap.
  • api/, prompts/, extensions/, default_config.yaml, plugin.yaml, README.md, and webui/ own tests/webhook endpoints, prompt fragments, hooks, settings, metadata, docs, and UI.

Local Contracts

  • Treat bot tokens, chat IDs, attachments, and user data as sensitive.
  • Keep allowed-user, group-mode, project, model, and /send controls enforced.
  • Install Telegram dependencies into the framework runtime only when required.
  • Agent profile picker actions change the top-level chat profile and must preserve existing subordinate agent profiles.
  • Model picker status shows the effective preset; clearing a chat override returns to its scoped preset rather than assuming Default.

Work Guidance

  • Coordinate bot lifecycle changes with job-loop hooks and settings reload behavior.

Verification

  • Smoke-test connection checks, polling or webhook delivery, per-user context reuse, attachments, and replies when practical.

Child DOX Index

No child DOX files.