From e0e83b54927044056f2b009af57978603f00601c Mon Sep 17 00:00:00 2001 From: arc53-machine <232052973+arc53-machine@users.noreply.github.com> Date: Tue, 29 Sep 2026 10:34:37 +0100 Subject: [PATCH] Document account names, fixed values and the Telegram default chat --- docs/content/Guides/Connectors.mdx | 12 +++++++++++- docs/content/Tools/basics.mdx | 2 +- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/docs/content/Guides/Connectors.mdx b/docs/content/Guides/Connectors.mdx index f9799832..ade46355 100644 --- a/docs/content/Guides/Connectors.mdx +++ b/docs/content/Guides/Connectors.mdx @@ -22,7 +22,17 @@ Open **Settings > Connectors**. Filters narrow the list by category, and **Conne **Knowledge** (formerly Sources) is what the assistant searches: uploads, links, and content synced from your connections. The **Add knowledge** and **Add Tool** dialogs, the composer's Knowledge and Tools menus, and the agent builder all start the same flow, and list tools grouped by the connection they use. A service offered two ways appears as one card: Confluence syncs pages into Knowledge and, through **Jira & Confluence**, lets agents search and update Jira and Confluence. GitHub does both from one connection: see [GitHub](#github). -A connector's page is the one place to manage it: its accounts (**Reconnect**, **Disconnect**), the Knowledge it syncs (**Sync now**), and its tools (on or off, and what each action may do). On the Knowledge and Tools pages, anything from a connection has **Manage connection** in its menu, which opens that page. Disconnecting keeps synced content but stops its sync. +A connector's page is the one place to manage it: its accounts (**Reconnect**, **Rename**, **Disconnect**), the Knowledge it syncs (**Sync now**), and its tools (on or off, and what each action may do). On the Knowledge and Tools pages, anything from a connection has **Manage connection** in its menu, which opens that page. Disconnecting keeps synced content but stops its sync. + +### Several accounts of one service + +You can connect the same service more than once, for example two Telegram bots. Give each account a name when you connect it (**Name this account**) or later with **Rename**. When you have more than one account of a service, its tools are listed as "Telegram ยท Alerts bot", and the assistant sees each account's actions under that account's name, so it can pick the right one. + +### Fixed values + +Under **Customize**, each action lists its parameters. A parameter is either left to the AI (**Let AI decide**) or set to **Always use** a value. A fixed value is sent on every call; the AI never sees it and can't change it, even when a prompt asks it to. Only the tool's owner can change fixed values. + +A Telegram connection can hold a **Default chat ID**. When it's set, messages always go to that chat. To find a chat's id, add the bot to the chat, send it a message, and open `https://api.telegram.org/bot/getUpdates`. The same bot with another default chat is a separate connection. When team members use their own accounts, each member's messages go to their own default chat. ### When a connection needs attention diff --git a/docs/content/Tools/basics.mdx b/docs/content/Tools/basics.mdx index 03581680..995f5216 100644 --- a/docs/content/Tools/basics.mdx +++ b/docs/content/Tools/basics.mdx @@ -59,7 +59,7 @@ DocsGPT includes a suite of pre-built tools designed to expand its capabilities { title: 'Telegram Bot', link: 'https://github.com/arc53/DocsGPT/blob/main/docsgpt/agents/tools/telegram.py', - description: 'Allows DocsGPT to send messages or images to Telegram chats via a Telegram Bot. Requires a bot token and chat ID.' + description: 'Allows DocsGPT to send messages or images to Telegram chats via a Telegram Bot. Requires a bot token; an optional default chat ID sends every message to one chat.' }, { title: 'PostgreSQL Database',