agent-profiles/suites-help/示例代码/Hello-World.md

Hello, World! 套件示例

一个最简单的套件，演示 workflow.yaml 和脚本结构。

文件结构

hello-world/
├── workflow.yaml
└── scripts/
    └── run.py

workflow.yaml

name: Hello World
description: 首个 AgentGIS 套件，接收一条消息并在容器中打印
version: 1.0.0
author: SuiteForge
tags: [示例, 入门]

params:
  message:
    type: string
    required: true
    desc: 要打印的消息

base_image: gis-base:latest

steps:
  - id: hello
    name: 打印消息
    script_id: run
    params:
      message: $params.message

scripts/run.py

#!/usr/bin/env python3
import sys, json

def run(params):
    message = params.get("message", "Hello, AgentGIS!")
    print(f"📢 {message}")
    return {
        "status": "completed",
        "message": message,
    }

if __name__ == "__main__":
    params = json.loads(sys.argv[1]) if len(sys.argv) > 1 else {}
    result = run(params)
    print(json.dumps(result, ensure_ascii=False))

执行

agc run /tmp/hello-output \
  --suite-id <your-suite-id> \
  --input message="你好，AgentGIS!"