For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/guide/concepts/overview.md.
  • English
  • First time with Octop: how the pieces fit

    You can start without learning how the process is built. Five pieces are enough: an expert answers, a model does the thinking, a knowledge base is the files it can look up, a connector is an app it can operate, and a channel is how you reach it from WeChat or Feishu.

    Octop web UI

    Web UI

    What each piece is for

    Where one question goes

    Suppose you have already authorized Tencent Meeting and uploaded a project proposal to a knowledge base. In Feishu you tell the linked expert: “Check my meetings tomorrow and turn the proposal into a 300-word summary.”

    1. Feishu hands the sentence to that expert. The channel only carries the message in and the reply out.
    2. The expert looks up tomorrow’s meetings. It calls the Tencent Meeting connector you authorized.
    3. The expert finds the relevant passages in the knowledge base. You leave the full document out of the composer.
    4. The model writes the summary from the schedule and those passages. The tone follows the persona you chose.
    5. The summary returns to Feishu. You can open the cited document under the reply.

    Conversation in the web UI and scheduled tasks follow the same path: the message reaches the expert, and the expert uses a knowledge base or connector when the request needs it.

    A practical order

    Send a first message

    Install with the quick start, then say something to the default expert main in Conversation.

    Switch to a specialist

    Open Experts → Discover Experts. Featured lists the templates that ship with Octop. Click Create. See Agents.

    Give it files and apps

    Upload a knowledge base, or connect one app you already use under Connectors.

    Reach it from your phone

    Scan a QR code to link Feishu, DingTalk, WeCom, or QQ. Add a scheduled task when you want a daily push.

    One person or several

    One Octop can have multiple sign-in accounts. Experts, chats, and workspaces you create stay visible to you. An administrator manages users and instance settings. Turn on Share with other users on an expert so other people on this instance can open that running expert. Turn on Shared on a knowledge base so they can read it.

    Experts on another Octop appear under Conversation → Cloud after you add a cloud collaboration link. When several experts should split one job in a single room, use an expert team.

    Where your data lives

    Chats, secrets, and workspaces stay on this machine under ~/.octop/. One octop run starts the web UI, messaging channels, and schedules together. See Data directory for each folder. Export with octop backup before you move machines.