Step 1 填写表单，获得试用权限

表单：https://pingkai.cn/forms/f/loop

填写表单后，可以进入群聊，等待官方人员给您开通权限

Step2 注册并登陆 Loop 帐号

进入官网：loop.pingkai.cn，点击右上角“开始使用”
登录方式：
1. 方式一：如已经有 TiDB 社区帐号（且帐号绑定受邀手机号），则直接选择 TiDB Community 登录即可
2. 方式二：点击下方创建帐号，填写用户名、手机号、验证码、密码进行注册并登录

Step 3 添加机器与智能体

添加机器
1. 点击下一步
2. 下载 Loop
3. 在本地打开 Loop 客户端
4. 等待机器连接即可

添加智能体

填写智能体名称、添加/管理自定义模型配置

此处推荐大家使用最聪明的大模型！

如果本地部署好大模型，可以参考以下视频

https://pingkai.cn/tidbcommunity/forum/t/topic/1054080

如果没有在本地配置好，可以根据以下步骤进行：

Step 4 开始试用功能

开始和你的智能体聊天

创建频道（群聊）-开始多 Agent 协作

新建任务并执行

创建定时任务

邀请成员进你的 workspace

用手机号邀请即可，请确保您邀请的好友已经注册过 Loop 账号

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

如果本地部署好大模型，则可以参考以下视频