跳转到内容
Greentic Docs

快速开始

本指南将帮助你在本地运行一个基础的 Greentic 数字员工。

前置条件

Section titled “前置条件”

开始之前，请确保你已经具备：

  • Rust 1.90 或更高版本（rustup default 1.90）
  • Node.js 18+（用于前端工具）
  • Git（用于克隆仓库）

安装

Section titled “安装”

  1. 安装 GTC CLI

    Terminal window
    cargo install greentic-cli

    或从源码构建：

    Terminal window
    git clone https://github.com/greenticai/greentic.git
    cd greentic/greentic
    cargo build --release

  2. 创建新的 bundle

    使用 wizard 根据你的目标配置创建新的 bundle：

    Terminal window
    gtc wizard --answers wizard-answers.yaml

    或以交互方式运行：

    Terminal window
    gtc wizard

  3. 配置 providers

    设置你的消息 providers（例如 Telegram、Slack）：

    Terminal window
    gtc setup ./my-bundle

    若需非交互式配置，可使用 answers 文件：

    Terminal window
    gtc setup --answers answers.json ./my-bundle

  4. 启动运行时

    启动你的数字员工：

    Terminal window
    gtc start ./my-bundle

示例：Hello World Flow

Section titled “示例：Hello World Flow”

创建一个简单 flow 来响应消息：

flows/hello.ygtc
name: hello_world
version: "1.0"
description: A simple greeting flow


nodes:
  - id: greet
    type: reply
    config:
      message: "Hello! I'm your digital worker."


triggers:
  - type: message
    pattern: "hello"
    target: greet

Bundle 结构

Section titled “Bundle 结构”

一个典型的 Greentic bundle 如下所示：

my-bundle/
├── greentic.demo.yaml      # Main configuration
├── providers/
│   └── messaging/
│       └── messaging-telegram.gtpack
├── apps/
│   └── my-app/
│       └── flows/
│           └── on_message.ygtc
└── seeds.yaml              # Seed data (optional)

配置文件

Section titled “配置文件”

主配置文件（greentic.demo.yaml）定义了你的整体设置：

greentic.demo.yaml
name: my-digital-worker
version: "1.0"


providers:
  messaging-telegram:
    pack: "providers/messaging/messaging-telegram.gtpack"
    setup_flow: "setup_default"


apps:
  my-app:
    path: "apps/my-app"
    default_flow: "on_message"


tenants:
  demo:
    name: Demo Tenant
    teams:
      default:
        channels:
          telegram:
            provider: messaging-telegram

下一步

Section titled “下一步”

现在你已经完成了基础环境搭建，可以继续：