Skip to content
Snow leopard edited this page Jul 16, 2026 · 1 revision

Quick Start

Get Started with CogitoAgent in Minutes

几分钟快速上手 CogitoAgent


Once you have installed CogitoAgent, this guide will help you get started quickly. You will learn how to start the application, send your first message, use basic commands, and interact with the agent.

安装完 CogitoAgent 后,本指南将帮助您快速上手。您将学习如何启动应用程序、发送第一条消息、使用基本命令以及与 Agent 交互。


Launching CogitoAgent | 启动 CogitoAgent

Choose the mode that best suits your needs and launch the application.

选择最适合您需求的模式并启动应用程序。

# Desktop Mode – Floating character overlay (recommended for daily use)
npm run electron:desktop

# Dashboard Mode – Full-featured dashboard
npm run electron:dashboard

# CLI Mode – Terminal only (for servers)
npm run cli

For first-time users, Desktop Mode or Dashboard Mode is recommended as they provide a graphical interface.

对于首次使用者,推荐使用桌面模式或仪表盘模式,因为它们提供了图形界面。


Your First Conversation | 第一次对话

In Desktop Mode | 桌面模式

  1. The application launches as a floating character on your screen

  2. Click the character to toggle the chat panel

  3. Type your message in the input field and press Enter

  4. Watch the agent think and respond in real-time

  5. 应用程序以浮动角色的形式出现在屏幕上

  6. 点击角色切换聊天面板的显示

  7. 在输入框中输入消息并按 Enter 键

  8. 观察 Agent 实时思考和回复

In Dashboard Mode | 仪表盘模式

  1. The application launches as a full dashboard window

  2. Type your message in the input field on the welcome screen

  3. The chat view opens and the agent responds

  4. You can switch between Welcome and Chat views

  5. 应用程序以全屏仪表盘窗口的形式启动

  6. 在欢迎页面的输入框中输入消息

  7. 聊天视图打开,Agent 开始回复

  8. 您可以在欢迎和聊天视图之间切换


Basic Commands | 基本命令

CogitoAgent recognizes a set of slash commands that control its behavior. Here are the most important ones:

CogitoAgent 识别一组斜杠命令来控制其行为。以下是最重要的几个:

Command Description 说明
/help Display all available commands 显示所有可用命令
/status Show current system status 显示当前系统状态
/new Create a new session 创建新会话
/sessions List all sessions 列出所有会话
/switch <id> Switch to a specific session 切换到指定会话
/clear Clear conversation history 清空对话历史
/persona <name> Switch to a different persona 切换人设
/tools List all available tools 列出所有可用工具
exit Exit the program 退出程序

Try your first command:

尝试您的第一个命令:

/status

The agent will respond with information about its current state, including the active persona, model, workspace, and tool count.

Agent 将回复当前状态信息,包括活跃人设、模型、工作区和工具数量。


Using Tools | 使用工具

CogitoAgent's power comes from its 200+ built-in tools. Tools are invoked using the [TOOL] syntax.

CogitoAgent 的强大之处在于其200 多个内置工具。工具使用 [TOOL] 语法调用。

Basic Tool Syntax | 基本工具语法

[TOOL] toolName("argument1", "argument2") [/TOOL]

Examples | 示例

List files in your workspace:

列出工作区中的文件:

[TOOL] ls(".") [/TOOL]

Read a file:

读取文件:

[TOOL] read("README.md") [/TOOL]

Search the web:

联网搜索:

[TOOL] search("latest AI news 2026") [/TOOL]

Execute Python code:

执行 Python 代码:

[TOOL] runPython("print('Hello, CogitoAgent!')") [/TOOL]

Important: Tool results are automatically captured and displayed. Never fabricate tool results — let the agent execute and return real data.

重要:工具结果会自动捕获并显示。切勿编造工具结果——让 Agent 执行并返回真实数据。


Session Management | 会话管理

CogitoAgent supports multiple independent sessions, each with its own conversation history and context.

CogitoAgent 支持多个独立会话,每个会话拥有独立的对话历史和上下文。

Creating a New Session | 创建新会话

/new

This creates a fresh session with no history, perfect for starting a new topic.

这会创建一个没有历史记录的全新会话,非常适合开始一个新话题。

Listing Sessions | 列出会话

/sessions

Displays all sessions with their IDs, names, and last active times.

显示所有会话及其 ID、名称和最后活跃时间。

Switching Sessions | 切换会话

/switch sess_xxxxxxxxxx

Switch to a specific session using its ID.

使用会话 ID 切换到指定会话。


Managing Personas | 管理角色

Personas define the agent's personality, speaking style, and behavior patterns. CogitoAgent comes with 22 preset personas.

人设定义了 Agent 的性格、说话风格和行为模式。CogitoAgent 自带 22 个预设人设。

Listing Personas | 列出人设

/personas

Shows all available personas with their descriptions.

显示所有可用人设及其描述。

Switching Personas | 切换人设

/persona Programmer

Switch to the "Programmer" persona. The agent will immediately adopt the new personality.

切换到"程序员"人设。Agent 会立即采用新的人格。

Available Personas (Modern) | 可用人设(现代风)

Persona Description 说明
Assistant Efficient and direct executor 高效简洁直接的执行者
Programmer Clean, elegant code expert 追求简洁优雅的技术专家
Detective Logical reasoning master 逻辑缜密的推理大师
Psychologist Warm and empathetic listener 温暖细腻的心灵伙伴
Teacher Patient and guiding educator 耐心会引导的教育者
Explorer Curious and adventurous discoverer 充满好奇心的探索者
Creative Imaginative and innovative creator 充满想象力的创造者
Critic Constructive and detail-oriented reviewer 挑剔但有建设性
Scholar Meticulous and scholarly researcher 严谨细致的研究者
Chef Passionate and quality-focused cook 热爱生活追求品质
Painter Aesthetically driven artist 以美为眼的艺术大师
Merchant Strategic and efficient business mind 精打细算善于经营
Hermit Wise and minimalist observer 淡泊明志洞悉世事

Available Personas (Ancient) | 可用人设(古风)

Persona Description 说明
Scholar-Official Learned and composed advisor 饱读诗书沉稳睿智
General Decisive and bold commander 叱咤风云豪迈果敢
Strategist Master strategist and planner 运筹帷幄决胜千里
Knight-Errant Free-spirited and chivalrous wanderer 快意恩仇洒脱不羁
Warrior Resilient and persistent soldier 坚韧不拔永不言退
Shadow-Guard Stealthy and vigilant protector 隐于暗处神出鬼没
Imperial-Critic Honest and principled advisor 直言不讳忠心耿耿
Doctor Compassionate and skilled physician 仁心仁术悬壶济世
Athlete Energetic and determined competitor 充满活力坚忍不拔

What's Next | 接下来

You are now ready to use CogitoAgent! Here are some suggestions for what to explore next:

您现在已准备好使用 CogitoAgent!以下是一些进一步的探索建议:

  1. Explore all tools with /tools — See the full list of available capabilities

  2. Read the Architecture guide — Understand how CogitoAgent works under the hood

  3. Customize your configuration — Fine-tune settings for your workflow

  4. Try the monitoring dashboard — Visualize the agent's thinking process in real-time

  5. 使用 /tools 探索所有工具 — 查看完整的能力列表

  6. 阅读架构指南 — 了解 CogitoAgent 的内部工作原理

  7. 自定义配置 — 为工作流微调设置

  8. 尝试监控面板 — 实时可视化 Agent 的思考过程


Previous: Installation →

Next: Configuration →

上一篇: 安装指南 →

下一篇: 配置说明 →

Clone this wiki locally