---
title: 快速开始
---

# 快速开始

即使暂时没有打通外部渠道，你也可以先用 Dashboard 的 `聊天` 页面验证 Agent 行为。
默认启动会使用真实 `pi` runtime；如果你只想先验证本地链路，可以在启动前设置 `PI_BOT_AGENT_MODE=mock`。

## 接入飞书机器人

1. 打开 [概览](/overview) 页面的「飞书配置」区域。
2. 填写 `App ID` 和 `App Secret`。
3. 点击保存。
4. 重启应用让配置生效。

### 飞书机器人配置

1. 在「权限管理」中配置以下权限：

```json
{
  "scopes": {
    "tenant": [
      "cardkit:card:write",
      "docx:document:readonly",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:send_as_bot"
    ],
    "user": [
      "docx:document:readonly"
    ]
  }
}
```

2. 在「事件与回调」中添加 `im.message.receive_v1` 事件，并将订阅方式设置为“使用长连接接收事件”。

## 发送第一条飞书消息

飞书接通后，你可以直接给机器人发私聊消息。

如果当前配置开启了群聊提及限制，那么群聊里需要先 `@机器人`，消息才会进入处理链路。