conductor-oss/conductor - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径项目截图 2 贡献者 298 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

5分钟快速开始Conductor工作流引擎

快速启动Conductor服务器，运行第一个工作流并体验其核心功能。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Java 21+ 必需

所需工具

Node.js

必需

操作步骤

安装Conductor CLI

使用npm全局安装Conductor命令行工具。

安装Conductor CLI

npm install -g @io-orkes/conductor-cli

预期结果：：安装成功，无错误输出。

如果遇到权限问题，请使用sudo或配置npm全局目录。

启动Conductor服务器

使用CLI启动本地Conductor服务器，包含内置UI。

启动Conductor服务器和UI

conductor start

预期结果：：看到服务器启动日志，并提示服务器已运行在 http://localhost:8080。

首次启动会下载服务器JAR，可能需要几分钟。请确保端口8080未被占用。

访问Conductor UI

在浏览器中打开Conductor的Web界面。

在默认浏览器中打开UI

open http://localhost:8080 (macOS) 或 start http://localhost:8080 (Windows)

预期结果：：浏览器中显示Conductor的用户界面，可以看到工作流、任务等模块。

如果无法打开，请检查服务器是否正在运行，或尝试直接访问链接。

运行一个示例工作流

使用CLI执行一个简单的内置工作流，验证引擎功能。

运行一个执行HTTP GET请求的示例工作流

conductor workflow run --name http_get_example --input '{"url": "https://httpbin.org/get"}'

预期结果：：返回工作流执行ID和状态，状态为RUNNING。

工作流正在后台执行。可以使用`conductor workflow get --workflowId <ID>`查看状态。

查看工作流执行结果

等待工作流完成并查看输出。

获取工作流的详细执行结果，包括输出

conductor workflow get --workflowId <上一步的执行ID> --includeOutput

预期结果：：工作流状态为COMPLETED，输出中包含来自httpbin.org的JSON响应数据。

如果状态为RUNNING，请稍等片刻后重试。

验证成功

确认Conductor服务器和工作流引擎已正常工作。

浏览器中能访问http://localhost:8080并看到Conductor UI

成功运行http_get_example工作流并获取到外部API的响应数据

快速提示

服务器管理

使用`conductor server stop`停止服务器。

CLI使用

CLI命令帮助：`conductor --help`。

API访问

所有CLI操作都有对应的REST API，可通过UI的'Swagger UI'或文档查看。

常见问题

启动服务器时提示端口8080被占用。

关闭占用该端口的应用，或使用`conductor start --port <新端口>`指定其他端口。

CLI命令`conductor`未找到。

确保npm全局安装的目录已添加到系统PATH环境变量中。

运行工作流时提示'workflow already exists'。

这是正常现象，说明该工作流已注册。可以使用`conductor workflow update`来更新它。

下一步

编写自定义Worker

学习如何创建执行具体业务逻辑的Worker服务。

定义新工作流

使用JSON或代码定义包含多个任务和决策逻辑的复杂工作流。

查看快速入门指南

阅读官方Quickstart guide，深入了解Worker开发、工作流重放等高级功能。

探索AI代理编排

了解如何使用Conductor编排LLM、MCP工具调用等构建智能代理。