Repository navigation
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 交互。
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 cliFor first-time users, Desktop Mode or Dashboard Mode is recommended as they provide a graphical interface.
对于首次使用者,推荐使用桌面模式或仪表盘模式,因为它们提供了图形界面。
-
The application launches as a floating character on your screen
-
Click the character to toggle the chat panel
-
Type your message in the input field and press
Enter -
Watch the agent think and respond in real-time
-
应用程序以浮动角色的形式出现在屏幕上
-
点击角色切换聊天面板的显示
-
在输入框中输入消息并按
Enter键 -
观察 Agent 实时思考和回复
-
The application launches as a full dashboard window
-
Type your message in the input field on the welcome screen
-
The chat view opens and the agent responds
-
You can switch between Welcome and Chat views
-
应用程序以全屏仪表盘窗口的形式启动
-
在欢迎页面的输入框中输入消息
-
聊天视图打开,Agent 开始回复
-
您可以在欢迎和聊天视图之间切换
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 将回复当前状态信息,包括活跃人设、模型、工作区和工具数量。
CogitoAgent's power comes from its 200+ built-in tools. Tools are invoked using the [TOOL] syntax.
CogitoAgent 的强大之处在于其200 多个内置工具。工具使用 [TOOL] 语法调用。
[TOOL] toolName("argument1", "argument2") [/TOOL]
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 执行并返回真实数据。
CogitoAgent supports multiple independent sessions, each with its own conversation history and context.
CogitoAgent 支持多个独立会话,每个会话拥有独立的对话历史和上下文。
/new
This creates a fresh session with no history, perfect for starting a new topic.
这会创建一个没有历史记录的全新会话,非常适合开始一个新话题。
/sessions
Displays all sessions with their IDs, names, and last active times.
显示所有会话及其 ID、名称和最后活跃时间。
/switch sess_xxxxxxxxxx
Switch to a specific session using its ID.
使用会话 ID 切换到指定会话。
Personas define the agent's personality, speaking style, and behavior patterns. CogitoAgent comes with 22 preset personas.
人设定义了 Agent 的性格、说话风格和行为模式。CogitoAgent 自带 22 个预设人设。
/personas
Shows all available personas with their descriptions.
显示所有可用人设及其描述。
/persona Programmer
Switch to the "Programmer" persona. The agent will immediately adopt the new personality.
切换到"程序员"人设。Agent 会立即采用新的人格。
| 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 | 淡泊明志洞悉世事 |
| 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 | 充满活力坚忍不拔 |
You are now ready to use CogitoAgent! Here are some suggestions for what to explore next:
您现在已准备好使用 CogitoAgent!以下是一些进一步的探索建议:
-
Explore all tools with
/tools— See the full list of available capabilities -
Read the Architecture guide — Understand how CogitoAgent works under the hood
-
Customize your configuration — Fine-tune settings for your workflow
-
Try the monitoring dashboard — Visualize the agent's thinking process in real-time
-
使用
/tools探索所有工具 — 查看完整的能力列表 -
阅读架构指南 — 了解 CogitoAgent 的内部工作原理
-
自定义配置 — 为工作流微调设置
-
尝试监控面板 — 实时可视化 Agent 的思考过程
Previous: Installation →
Next: Configuration →
上一篇: 安装指南 →
下一篇: 配置说明 →