mirror of
https://github.com/memohai/Memoh.git
synced 2026-04-27 07:16:19 +09:00
2 lines
7.8 KiB
JavaScript
2 lines
7.8 KiB
JavaScript
import{_ as e,o as r,c as o,ag as a}from"./chunks/framework.CvgP6Fyv.js";const m=JSON.parse('{"title":"Bot Management","description":"","frontmatter":{},"headers":[],"relativePath":"getting-started/bot.md","filePath":"getting-started/bot.md","lastUpdated":1774787421000}'),n={name:"getting-started/bot.md"};function i(s,t,d,l,g,c){return r(),o("div",null,[...t[0]||(t[0]=[a('<h1 id="bot-management" tabindex="-1">Bot Management <a class="header-anchor" href="#bot-management" aria-label="Permalink to "Bot Management""></a></h1><p>A Bot is an independent AI agent that comes with its own isolated container, persistent memory, and configurable personality. Bots can chat via various messaging platforms (Channels) and perform complex tasks using specialized tools.</p><h2 id="creating-a-bot" tabindex="-1">Creating a Bot <a class="header-anchor" href="#creating-a-bot" aria-label="Permalink to "Creating a Bot""></a></h2><ol><li>Navigate to the <strong>Bots</strong> page from the sidebar.</li><li>Click the <strong>Create Bot</strong> button.</li><li>Fill in the basic info: <ul><li><strong>Display Name</strong>: The name users will see in chats.</li><li><strong>Avatar</strong>: A URL for the bot's profile picture.</li></ul></li><li>Click <strong>Create</strong>.</li></ol><hr><h2 id="bot-detail-page" tabindex="-1">Bot Detail Page <a class="header-anchor" href="#bot-detail-page" aria-label="Permalink to "Bot Detail Page""></a></h2><p>Once created, clicking on a bot card takes you to its <strong>Detail Page</strong>, where you can manage its entire lifecycle through specialized tabs.</p><h3 id="tab-overview" tabindex="-1">Tab Overview <a class="header-anchor" href="#tab-overview" aria-label="Permalink to "Tab Overview""></a></h3><table tabindex="0"><thead><tr><th>Tab</th><th>Description</th></tr></thead><tbody><tr><td><strong>Overview</strong></td><td>Health checks for container, database, channels, and memory.</td></tr><tr><td><strong>General</strong></td><td>Core settings: models, providers, reasoning, heartbeat, compaction, and danger zone.</td></tr><tr><td><strong>Container</strong></td><td>Container lifecycle (create/start/stop), snapshots, data export/import.</td></tr><tr><td><strong>Memory</strong></td><td>Browse, search, create, edit, and compact memories.</td></tr><tr><td><strong>Platforms</strong></td><td>Channel configurations (Telegram, Discord, Feishu, QQ, Matrix, WeCom, WeChat, Web).</td></tr><tr><td><strong>Access</strong></td><td>ACL rules — control who can chat with the bot.</td></tr><tr><td><strong>Email</strong></td><td>Email bindings and outbox.</td></tr><tr><td><strong>Terminal</strong></td><td>Interactive terminal access to the bot's container.</td></tr><tr><td><strong>Files</strong></td><td>File manager for the bot's container filesystem.</td></tr><tr><td><strong>MCP</strong></td><td>MCP connection management (Stdio, Remote, OAuth).</td></tr><tr><td><strong>Heartbeat</strong></td><td>Heartbeat configuration and execution logs.</td></tr><tr><td><strong>Compaction</strong></td><td>Memory compaction logs.</td></tr><tr><td><strong>Schedule</strong></td><td>Cron-based scheduled tasks and execution logs.</td></tr><tr><td><strong>Skills</strong></td><td>Markdown-based skill files that define bot personality and capabilities.</td></tr></tbody></table><hr><h2 id="configuring-the-bot-s-core-settings" tabindex="-1">Configuring the Bot's Core Settings <a class="header-anchor" href="#configuring-the-bot-s-core-settings" aria-label="Permalink to "Configuring the Bot's Core Settings""></a></h2><p>After creating a bot, the most important step is configuring its runtime settings. These define how the bot talks, remembers, searches, and uses browser automation.</p><ol><li>Navigate to your bot's <strong>Detail Page</strong>.</li><li>Go to the <strong>General</strong> tab.</li><li>Configure the core fields: <ul><li><strong>Chat Model</strong>: Used for standard conversations with users.</li><li><strong>Memory Provider</strong>: Select the memory backend the bot should use.</li><li><strong>Search Provider</strong>: Select the search engine provider for web search.</li><li><strong>Browser Context</strong>: Select the browser profile the bot should use for browser automation.</li></ul></li><li>Click <strong>Save</strong> at the bottom of the form.</li></ol><p>If you have not created these resources yet, set them up first:</p><ul><li><a href="/getting-started/provider-and-model.html">LLM Provider and Model</a></li><li><a href="/memory-providers/builtin.html">Built-in Memory Provider</a></li><li><a href="/getting-started/search-provider.html">Search Providers</a></li><li><a href="/getting-started/browser.html">Browser Contexts</a></li></ul><hr><h2 id="general-tab-reference" tabindex="-1">General Tab Reference <a class="header-anchor" href="#general-tab-reference" aria-label="Permalink to "General Tab Reference""></a></h2><p>The <strong>General</strong> tab contains all the core parameters that define your bot's behavior and runtime configuration.</p><table tabindex="0"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>Chat Model</strong></td><td>The main LLM used for generating chat responses.</td></tr><tr><td><strong>Memory Provider</strong></td><td>The memory backend assigned to the bot. The built-in provider can optionally define its own memory and embedding models.</td></tr><tr><td><strong>Search Provider</strong></td><td>The search engine used for web browsing capabilities.</td></tr><tr><td><strong>Browser Context</strong></td><td>The browser environment used for web automation, such as viewport, locale, and mobile behavior.</td></tr><tr><td><strong>Language</strong></td><td>The bot's primary communication language.</td></tr><tr><td><strong>Reasoning Enabled</strong></td><td>If the selected model supports reasoning (like OpenAI o1), enable this to use its deep thinking capabilities.</td></tr><tr><td><strong>Reasoning Effort</strong></td><td>Set the level of reasoning effort (<code>low</code>, <code>medium</code>, <code>high</code>).</td></tr><tr><td><strong>Heartbeat Enabled</strong></td><td>Toggle periodic autonomous activity.</td></tr><tr><td><strong>Heartbeat Interval</strong></td><td>How often (in minutes) the heartbeat triggers.</td></tr><tr><td><strong>Heartbeat Model</strong></td><td>The LLM used for heartbeat tasks (can differ from the chat model).</td></tr><tr><td><strong>Compaction Enabled</strong></td><td>Toggle automatic memory compaction.</td></tr><tr><td><strong>Compaction Model</strong></td><td>The LLM used for memory compaction.</td></tr><tr><td><strong>ACL Default Effect</strong></td><td>Default access control behavior (<code>allow</code> or <code>deny</code>) when no ACL rule matches.</td></tr></tbody></table><hr><h2 id="terminal-tab" tabindex="-1">Terminal Tab <a class="header-anchor" href="#terminal-tab" aria-label="Permalink to "Terminal Tab""></a></h2><p>The <strong>Terminal</strong> tab provides interactive shell access to the bot's container:</p><ul><li>Open multiple terminal tabs simultaneously.</li><li>Execute commands directly inside the container.</li><li>Requires the container to be running.</li></ul><hr><h2 id="deleting-a-bot" tabindex="-1">Deleting a Bot <a class="header-anchor" href="#deleting-a-bot" aria-label="Permalink to "Deleting a Bot""></a></h2><p>To permanently remove a bot and all its associated data (including container files and memory):</p><ol><li>Navigate to the <strong>General</strong> tab in the Bot Detail page.</li><li>Scroll to the <strong>Danger Zone</strong> at the bottom.</li><li>Click <strong>Delete Bot</strong> and confirm the action.</li></ol><blockquote><p><strong>Warning</strong>: This action is irreversible. All persistent data for this bot will be lost.</p></blockquote>',28)])])}const b=e(n,[["render",i]]);export{m as __pageData,b as default};
|