AI Agent Team Guide — RestoSuite Internal Portal

Communication Platforms

通讯平台 · Use the right channel for the right purpose

01

Lark (飞书)

主通讯平台 · Primary Platform

All 10 Agents + all team members. Daily work, project follow-ups, business communication.

全员 + 所有 Agent 主频道，日常业务、项目跟进

系统专用通道 · System Channel

Hubert + Nova only. Server approvals, system alerts, security notifications.

Hubert 专属，系统操作审批、服务器报警

Email (AgentMail)

长文 / 汇总专用 · Long-form & Summaries

Select Agents have mailboxes. Agents check email every 10 minutes. Not for urgent requests.

部分 Agent 已配置邮箱，每 10 分钟处理一次，非即时通讯

WhatsApp Business

对外客户渠道 · External (Coming Soon)

Chris / Sophia / Pearl. External customer support and sales follow-ups. Application in progress.

客服 + 销售对外渠道，申请中，即将开通

Core Rules

核心使用规则 · Follow these rules to get the best results

02

1

Always communicate with Agents inside the designated group chats

所有 Agent 沟通必须在 Hubert 创建的指定训练群中进行，不要单独私聊

All Agent interactions must happen in the training groups created by Hubert — not in direct private chats. This keeps conversations visible, traceable, and useful for the whole team to learn from.

便于团队协作、留存记录、互相学习，也方便 Hubert 观察和校正训练方向

Required · 必须遵守

2

Pre-process your request using your own AI tool before sending to an Agent

发出前先用个人 AI 工具做一次信息筛选和流程简化，再发给 Agent

Use Claude Sonnet, ChatGPT, Gemini, or similar to turn your rough ideas into clear, structured instructions before sending to the Agent. This reduces unnecessary back-and-forth, lowers token usage, and significantly improves output quality.

推荐使用 Claude Sonnet、ChatGPT 或 Gemini，把原始想法整理成清晰指令，减少 token 消耗，提升响应质量

Example · 示例

✓ Good: "Generate a proposal for Toast Box, 3 outlets, POS + KDS + Membership, full-service package, contact: Roger Yip"
✓ 好的指令: 帮我生成 Toast Box 3 家门店的报价单，POS + KDS + 会员系统，正餐套餐，联系人 Roger Yip

✗ Vague: "Help me do a proposal" · 不好: 帮我做个报价

Saves tokens · 节省 token

3

Use the right Agent for the right task

找对 Agent，不要随便问任何一个

Each Agent has a clear scope. Sales questions → Steven / Sophia. Product how-to → Benedict. Project tracking → Pearl. Customer support → Chris. Going to the wrong Agent wastes tokens and may return inaccurate answers.

每个 Agent 有明确职责边界。找错 Agent 会浪费 token，也可能得到不准确的答案

Accuracy · 提高准确率

4

Know the difference between Agent Skills and Shared Skills

区分 Agent Skill（专属技能）和 Shared Skill（共享技能）

Some capabilities belong to a specific Agent (e.g. Mary's 35 marketing skills, Sophia's HubSpot templates). Others are shared across the team (e.g. product knowledge base, document generation). If unsure, ask Hubert before building to avoid duplication.

部分技能只属于特定 Agent（如 Mary 的 35 个营销技能），部分是全团队共享的（如产品知识库）。不确定时找 Hubert 确认，避免重复建设

Training efficiency · 训练效率关键

5

Do not send highly sensitive information to Agents

不要将高度敏感信息发给 Agent

Do not share customer passwords, bank account numbers, personal identity data, or confidential credentials with Agents. Agents can analyse screenshots and documents, but information security remains your responsibility.

客户密码、银行账号、个人隐私数据等不要通过 Agent 处理。Agent 可以分析截图和文档，但信息安全由你自己负责

Security boundary · 安全边界

6

System operations require Hubert's approval — never bypass the process

系统操作需要 Hubert 审批，不要绕过流程

Any system-level operation request (server changes, permission modifications, etc.) must be formatted by Olivia and forwarded to Hubert for approval. Only Nova executes approved operations. Business Agents do not run system commands.

系统级操作请求通过 Olivia 格式化后转达 Hubert，由 Nova 执行。业务 Agent 不执行系统命令

Security architecture · 安全架构

7

Company AI Agents are for work-related tasks only — strictly no personal use

公司 AI Agent 只能用于与公司工作相关的内容，严禁用于个人用途

All company Agents are trained on RestoSuite's business knowledge — products, customers, SOPs, and workflows. Using Agents for personal tasks (personal queries, entertainment, non-work conversations, etc.) directly corrupts their Skills, memory, and knowledge base, causing confusion and degrading performance for the entire team.

公司所有 Agent 的知识库、Skill 和 Memory 均围绕 RestoSuite 业务建立。将 Agent 用于个人用途（个人问题、娱乐、非工作对话等）会直接污染 Agent 的 Skill、Memory 和知识库，导致数据混乱，影响全团队的使用质量

⚠️ Violation consequences · 违规后果

Any team member found using company Agents for non-work purposes will receive a formal written warning. Repeated violations will be escalated to management.
一经发现将给予严重书面警告，重复违规将上报管理层处理。

⚠️ Strict policy · 严格执行

Current Model

当前模型说明 · Claude Sonnet 4.6 API

03

⚡

Currently running Claude Sonnet 4.6 API — higher cost, higher capability

现阶段使用 Claude Sonnet 4.6 API（较高成本），保障前期搭建稳定性和复杂问题理解能力

Once the system is stable, we will step down to Claude 4.5 or a lower-cost model. In the meantime, please be deliberate about instruction quality to minimise unnecessary back-and-forth. · 待系统稳定后将逐步降级至 Claude 4.5。请有意识地提升指令质量，减少不必要的来回对话。

Email Channel

邮件频道说明 · All 10 Agents with AgentMail mailboxes

04

📬

All 10 Agents now have AgentMail mailboxes — checked every 10 minutes

全部 10 个 Agent 已完成 AgentMail 邮箱配置，每 10 分钟读取一次

Best for: long-form documents, meeting summaries, reports, non-urgent information. Not for urgent requests — use Lark instead. · 适合长文件、会议汇总、汇报等不紧急内容。紧急事项请用 Lark。

Agent Mailboxes · Agent 邮箱地址

N

Nova

Restosuite_Nova@agentmail.to

S

Steven

Restosuite_Steven@agentmail.to

S

Sophia

Restosuite_Sophia@agentmail.to

P

Pearl

Restosuite_Pearl@agentmail.to

A

Ava

Restosuite_Ava@agentmail.to

M

Mei

Restosuite_Mei@agentmail.to

M

Mary

Restosuite_Mary@agentmail.to

C

Chris

Restosuite_Chris@agentmail.to

B

Benedict

Restosuite_Benedict@agentmail.to

O

Olivia

Restosuite_Oliva@agentmail.to

Your 10 Agents

10 个专属 Agent · Each Agent has a defined role

05

N

Nova

Executive Coordinator

Hubert 专属协调员

Reports to: Hubert · 汇报对象：Hubert
Task breakdown, financial analysis, system oversight
指令分解、财务分析、系统管理
Restosuite_Nova@agentmail.to

Telegram Email

S

Steven

Sales Strategist

销售策略专家

Reports to: Derrick · 汇报对象：Derrick
Pitches, pricing, competitor analysis
话术设计、定价策略、竞品分析
Restosuite_Steven@agentmail.to

Lark Email

S

Sophia

Sales Executive

销售执行助理

Reports to: Steven · 汇报对象：Steven
Follow-ups, proposals, HubSpot CRM
客户跟进、报价生成、HubSpot 更新
Restosuite_Sophia@agentmail.to

Lark Email

P

Pearl

Implementation Lead

项目实施负责人

Reports to: Mia · 汇报对象：Mia
Project tracking, requirements, bug follow-up
项目追踪、需求整理、Bug 跟进
Restosuite_Pearl@agentmail.to

Lark Email

A

Ava

Asset Manager

资产管理专家

Reports to: Mia + Herman · 新马两地
License expiry, hardware inventory, service packages
License 提醒、硬件库存、服务配套
Restosuite_Ava@agentmail.to

Lark Email

M

Mei

MY Channel Manager

马来西亚渠道专家

Reports to: Herman · 汇报对象：Herman
Channel management, commission calc
渠道管理、分润计算
Restosuite_Mei@agentmail.to

Lark Email

M

Mary

Digital Marketing

数字营销专员

Reports to: Steven · 服务对象：全员
Content creation, 35 marketing skills
内容创作、35 个营销技能
Restosuite_Mary@agentmail.to

Lark Email

C

Chris

Customer Support

客服支持专家

Reports to: Hui Qi · 汇报对象：Hui Qi
Issue triage, bug tracking, retention
问题分流、Bug 追踪、客户留存
Restosuite_Chris@agentmail.to

Lark Email

B

Benedict

Product Knowledge Base

产品知识库

Reports to: Mia · 服务对象：全员
Product Q&A, release notes, tutorials
产品解答、发版公告、教程推荐
Restosuite_Benedict@agentmail.to

Lark Email

O

Olivia

Internal Info Hub

内部信息枢纽

Reports to: Nova · 服务对象：全员
Daily/weekly reports, approvals, cross-team
日报周报、审批转达、跨部门协调
Restosuite_Oliva@agentmail.to

Lark Email

Quick Reference by Team

各团队快速索引 · Find the right Agent for your team

06

Team · 团队	Primary Agents · 主要对接 Agent
SG Sales Team 新加坡销售团队	Steven · Sophia · Benedict
SG Implementation Team 新加坡实施团队	Pearl · Ava · Benedict
MY Channel Team 马来西亚渠道团队	Mei · Ava · Benedict
CS Team (SG & MY) 新马客服团队	Chris · Benedict · Ava
All Staff · 全员	Olivia · Mary · Benedict
Hubert only · Hubert 专属	Nova (via Telegram)

Skill Training Guide

Skill 训练指引 · Agent Skill vs Shared Skill

07

Skill Type · 类型	Examples · 示例	Owner · 归属
Agent Skill 专属技能	Mary's 35 marketing skills, Sophia's HubSpot templates, Chris's support scripts	Specific Agent only · 特定 Agent 专属
Shared Skill 共享技能	Product knowledge base, email brand templates, document generation, implementation SOP	All Agents · 全团队共享 /root/.hermes/shared-skills/

Recommended Workflow

推荐工作流程 · Steps before sending any instruction

08

🎯

Define your task

明确要做什么

✏️

Refine with Claude / ChatGPT

用 AI 工具整理指令

Find the right Agent

找对应 Agent

Send in the group chat

在训练群发送

Review & refine

检查，反馈调整

Security & Approval Flow

安全架构与审批流程 · Three-tier protection system

09

1

Team member submits a system operation request via any Agent

团队成员通过任何 Agent 提出系统操作请求

2

Agent refuses to execute immediately and notifies Olivia

Agent 拒绝立即执行，通知 Olivia

3

Olivia formats the request: Requester / Channel / Operation / Reason / Time

Olivia 格式化申请：申请人 / 渠道 / 操作内容 / 原因 / 时间

4

Olivia sends 🔐 approval request to Hubert via Telegram (through Nova)

Olivia 通过 Telegram 向 Hubert 发送 🔐 审批申请

5

Hubert replies "Approve" or "Reject" — Nova executes only after approval

Hubert 回复「批准」或「拒绝 + 原因」，Nova 获批后才执行

Lark Bot Pairing

首次使用：Lark Bot 配对 · One-time setup per Agent

10

ℹ️

Why is this needed? · 为什么需要配对？

Each Agent Bot on Lark requires a one-time pairing code to link your Lark account to the Agent. This is a security step — without it, the Agent cannot recognise who you are and will not respond.

每个 Lark Bot 需要一次性配对码，将你的飞书账号与 Agent 绑定。这是安全验证步骤，未配对的账号 Agent 不会回应。

Step-by-step · 配对步骤

1

Open Lark and find the Agent Bot you want to use (e.g. AI-Sophia-Sales)

打开飞书，找到你需要使用的 Agent Bot（例如 AI-Sophia-Sales）

2

Send any message to the Bot — it will reply with a pairing code

向 Bot 发送任意消息，Bot 会回复一串配对码（Pairing Code）

              Example reply · Bot 回复示例：

              🔑 Your pairing code: XXXXXX

              Please send this code to your administrator to complete setup.

3

Screenshot or copy the pairing code and send it to Hubert

截图或复制配对码，发送给 Hubert

⚠️ Include in your message · 发送时请注明：
Your name · 你的姓名 + Agent name · Agent 名称 + Pairing code · 配对码
e.g. "Kenneth — AI-Sophia-Sales — 配对码：XXXXXX"

4

Hubert will approve the pairing on the server side — usually within the same working day

Hubert 会在服务器端运行审批指令完成配对，通常在同一工作日内完成

nova pairing approve lark [配对码]

5

You will receive a confirmation — you can now chat with the Agent freely

配对成功后你会收到确认消息，之后即可正常使用该 Agent，无需再次配对

Important notes · 注意事项

✓

Each pairing is one-time only per Agent — once done, you never need to do it again for that Agent.
每个 Agent 只需配对一次，完成后永久有效

✓

If you need access to multiple Agents, repeat steps 1–4 for each one separately.
如果需要使用多个 Agent，每个 Agent 分别重复步骤 1–4

⚠️

The pairing code expires quickly — send it to Hubert promptly after receiving it.
配对码有有效期，收到后请尽快发给 Hubert，不要拖延

✗

Do not share your pairing code with colleagues — each person must generate their own.
配对码不能共享，每位同事必须自己生成自己的配对码

Common Issues

常见问题与处理方法 · Troubleshooting guide

11

⏳

Agent is stuck on a long task and not responding

Agent 卡在长任务中，发消息没有回应（显示 "Still working… iteration X/90" 或 "Interrupting current task"）

Steps to follow · 处理步骤

1

Do not keep sending messages to the stuck Agent

不要反复发消息给卡住的 Agent，这会让情况更混乱

2

Notify Hubert directly in Lark with the following information

在 Lark 直接通知 Hubert，附上以下信息

                🚨 Agent stuck — [Agent name]

                Task: [what you asked it to do · 你让它做什么]

                Status shown: [e.g. "Still working… iteration 2/90"]

                Time elapsed: [how long · 已卡多久]

                Lark channel: [which group · 哪个群]

3

Wait for Hubert to restart the Gateway — do not attempt to restart yourself

等待 Hubert 重启 Gateway，不要自行尝试重启，Gateway 重启由 Nova 执行

4

Once the Agent is back online, re-send your original request

Agent 恢复正常后，重新发送你的原始请求即可

🔇

Agent is completely unresponsive — no reply at all

Agent 完全没有回应，发消息石沉大海（Gateway 可能已停止运行）

Steps to follow · 处理步骤

1

Wait 2 minutes and try once more — the Agent may be processing another task

等待 2 分钟后再试一次，Agent 可能正在处理其他任务

2

Still no response — notify Hubert in Lark immediately

仍无回应，立即在 Lark 通知 Hubert，说明是哪个 Agent、哪个群、从什么时候开始没有回应

3

Hubert will check the Gateway status and restart if needed via Nova

Hubert 会通过 Nova 检查 Gateway 状态并决定是否重启

🤔

Agent replied but the output is wrong or unexpected

Agent 回复了，但内容不对、答非所问，或质量很差

1

First — try refining your instruction before assuming it's a system issue

先检查自己的指令是否足够清晰具体，80% 的情况是指令不够详细导致的，不是系统问题

2

Tell the Agent specifically what was wrong and what you need instead

直接告诉 Agent 哪里不对、需要怎么改，不要重新开始一个新对话

3

If the Agent consistently gives wrong answers on a specific topic — report to Hubert

如果某个 Agent 在某类问题上持续答错，可能是 Skill 或知识库需要更新，报告给 Hubert

Quick Summary · 快速一览

Symptom · 症状	Action · 处理	Escalate to · 上报
⏳ Stuck — "Still working / Interrupting"	Stop sending. Note task status.	Notify Hubert in Lark
🔇 No reply at all (> 2 min)	Try once more, then escalate.	Notify Hubert in Lark
🤔 Wrong / poor output	Refine instruction. Give feedback inline.	Hubert only if persistent
🔁 All Agents down	Do not attempt anything.	Notify Hubert immediately