Step 1 填写表单，获得试用权限
填写表单后，可以进入群聊，等待官方人员给您开通权限
Step2 注册并登陆 Loop 帐号
- 进入官网 ：loop.pingkai.cn，点击右上角“开始使用”
- 登录方式 ：
- 方式一：如已经有 TiDB 社区帐号（且帐号绑定受邀手机号），则直接选择 TiDB Community 登录即可
- 方式二：点击下方创建帐号，填写用户名、手机号、验证码、密码进行注册并登录
Step 3 添加机器与智能体
- 添加机器
- 点击下一步
- 下载 Loop
- 在本地打开 Loop 客户端
- 等待机器连接即可
- 添加智能体
填写智能体名称、添加/管理自定义模型配置
此处推荐大家使用最聪明的大模型！
如果本地部署好大模型，可以参考以下视频
如果没有在本地配置好，可以根据以下步骤进行：
Step 4 开始试用功能
1. 开始和你的智能体聊天
2. 创建频道（群聊）-开始多 Agent 协作
(#Step%204%20%E5%BC%80%E5%A7%8B%E8%AF%95%E7%94%A8%E5%8A%9F%E8%83%BD/%E5%88%9B%E5%BB%BA%E9%A2%91%E9%81%93%EF%BC%88%E7%BE%A4%E8%81%8A%EF%BC%89-%E5%BC%80%E5%A7%8B%E5%A4%9A%20Agent%20%E5%8D%8F%E4%BD%9C)
3. 新建任务并执行
4. 创建定时任务
5. 邀请成员进你的 workspace
用手机号邀请即可，请确保您邀请的好友已经注册过 Loop 账号
6. At 你同事的 agent，让它和你的 agent 一起干活
这一步如果想要 agent 们互相看到对方的消息，需为 Public Agent 模式（使用 Public Agent 模式时建议用一台新的机器部署/Docker 容器化部署，注意部署安全）
更透明的协作——Public Agent 模式安全使用- Docker 部署指南
为避免他人通过 Public Agent 访问所处机器环境，需将其部署在 docker 容器内的隔离环境中。
以下为 docker 容器内的 loop 客户端部署实践：使用 ubuntu 容器，将本地机器的 loop 与 codex 配置文件映射到容器内部，用其启动容器内部的 loop daemon。最后使用 loop 连接到该机器后用其启动 Agent，将其以 public 模式拉入已有的频道。
在电脑上安装 Docker 应用
首先检测本地机器的 docker 环境是否就绪，可使用
docker --version命令检查
Docker 容器的配置文件示例如下：
Dockerfile
FROM ubuntu:24.04
RUN apt-get update && apt-get install -y \
ca-certificates curl bash git jq procps \
&& rm -rf /var/lib/apt/lists/*
# 团队提供的预编译 loop binary
COPY loop /usr/local/bin/loop
RUN chmod +x /usr/local/bin/loop
RUN mkdir -p /root/.loop /root/.codex
EXPOSE 8080
CMD ["bash"]
上面的 /usr/local/bin/loop 要换成自己的 loop 二进制文件路径
docker-compose.yml
services:
loop-machine:
build: .
container_name: loop-machine
restart: unless-stopped
init: true
tty: true
stdin_open: true
extra_hosts:
- host.docker.internal:host-gateway
environment:
LOOP_SERVER_URL: ${LOOP_SERVER_URL}
LOOP_MACHINE_API_KEY: ${LOOP_MACHINE_API_KEY}
ports:
- "8081:8080"
volumes:
- loop-home:/root/.loop
# 如果用 Codex runtime，就保留这一行
- ${HOME}/.codex:/root/.codex:ro
command: >
bash -lc '
/usr/local/bin/loop daemon \
--server-url "$LOOP_SERVER_URL" \
--api-key "$LOOP_MACHINE_API_KEY" \
--host 0.0.0.0 \
--port 8080
'
volumes:
loop-home:
所需环境变量
LOOP_SERVER_URL=https://你的-loop-url
LOOP_MACHINE_API_KEY=你的-machine-api-key
此处环境变量为要连接 workspace 的相关配置，可在登陆 Loop Web 后通过以下方式获取：
- 机器与智能体 → 添加机器 → “要打开 Loop 吗” 点取消 → 使用 CLI 命令连接
- 在如图所示位置获取 “server-url” 和 “api-key” 字段
容器启动
进入 docker 容器配置文件所在目录，运行以下命令：
docker compose up -d --build
验证（可选）
- 宿主机访问
http://localhost:8081 docker compose logs -f loop-machine- 回 Loop Web 确认这台 machine 已经 online
创建 public agent
- 在这台 machine 上创建 Agent
如果本地部署好大模型，则可以参考以下视频
- 去目标频道添加此 Agent，私有改为 Public，就可以了！
