The world's first cross-platform AI agent platform compatibility tool

With just a single binary file, you can locally achieve seamless conversion of DSL files between different AI agent platforms (iFlytek, Dify, Coze), enabling AI agent workflow ecosystem interoperability. Using iFlytek (Spark Agent) as the hub, it unifies parsing into intermediate DSL, then generates according to the target platform, supporting automatic recognition, concurrent batch processing, and strict validation.

• Project Overview
• Visualization
• Quick Start
• CLI Reference
• Development & Testing
• FAQ
• License & Credits

• Dify ↔ iFlytek (bidirectional)
• Coze ↔ iFlytek (bidirectional, YAML)
• Dify → iFlytek → Coze (recommended path)
• Coze → iFlytek → Dify
• Coze ZIP → iFlytek (native support)

Not supported:

• Dify ↔ Coze direct conversion (please use iFlytek as hub)
• iFlytek → Coze ZIP (currently does not support ZIP target format)

To maintain workflow structure integrity when encountering node types not supported by the target platform:

• Use "code node" as placeholder to replace the node
• Write the original node's specific type in the code node title for easy manual adjustment later
• Preserve input/output edge connections so the flow can continue running
• Under --verbose, output details and statistics, such as:
  • Converting unsupported node type '4' (ID: 133604) to code node placeholder
  • 25 unsupported nodes were converted to code node placeholders

• Concurrent batch: batch command uses CPU concurrency, supports file mode and overwrite
• Validation pipeline: structure/semantic/platform three-level validation with friendly error messages
• Node coverage: start / end / llm / code / condition / classifier / iteration

• Current status: Coze official workflow does not support YAML import/export
• Solution: We maintain a fork that provides YAML import/export capabilities
• Repository: https://github.com/2064968308github/coze_transformer
• Usage: First use that repository to get Coze YAML, then use this tool for cross-platform conversion (e.g., Coze YAML → iFlytek, or iFlytek → Coze YAML)

sequenceDiagram
    participant Source as Source Platform DSL
    participant Parser as Parser
    participant Unified as Unified DSL
    participant Validator as Validator
    participant Generator as Generator
    participant Target as Target Platform DSL

    Source->>Parser: Original DSL file
    Parser->>Unified: Parse to unified format
    Unified->>Validator: Validate DSL correctness
    Validator->>Unified: Validation passed
    Unified->>Generator: Generate target format
    Generator->>Target: Target platform DSL

agentbridge/
├── cmd/                    # CLI entry point
│   ├── main.go            # Main program
│   ├── convert.go         # Convert command
│   └── validate.go        # Validate command
├── core/                  # Core services
│   └── services/          # Conversion service implementation
├── platforms/             # Platform implementations
│   ├── iflytek/          # iFlytek platform
│   ├── dify/             # Dify platform
│   └── coze/             # Coze platform
├── internal/             # Internal models
│   └── models/           # Unified DSL definitions
├── main.go               # Root entry point for go install
└── registry/             # Strategy registry

Requirements: Go 1.21+

# Install from GitHub (requires Go 1.21+)
go install github.com/iflytek/agentbridge@latest

# Verify installation
agentbridge --version
agentbridge --help

# Clone the repository
git clone https://github.com/iflytek/agentbridge.git
cd agentbridge

# Build
go build -o agentbridge .

# Run
./agentbridge --help

# iFlytek → Dify
agentbridge convert --from iflytek --to dify --input agent.yml --output dify.yml

# Dify → iFlytek
agentbridge convert --from dify --to iflytek --input dify.yml --output agent.yml

# iFlytek → Coze (YAML)
agentbridge convert --from iflytek --to coze --input agent.yml --output coze.yml

# Coze ZIP → iFlytek (ZIP auto-detected as Coze)
agentbridge convert --to iflytek --input workflow.zip --output agent.yml --verbose

# Concurrent batch conversion
agentbridge batch --from iflytek --to dify --input-dir ./workflows --output-dir ./converted --workers 4 --overwrite

# With pattern filtering
agentbridge batch --from iflytek --to dify --input-dir ./tests/fixtures/iflytek --pattern "iflytek*.yml" --output-dir ./out --workers 4 --overwrite

# Validate DSL file
agentbridge validate --input agent.yml

# Quiet mode (errors only)
agentbridge convert --from iflytek --to dify --input agent.yml --output dify.yml --quiet

• Purpose: Cross-platform conversion
• Required: --to, --input/-i, --output/-o
• Optional: --from (auto-detected when omitted, ZIP→Coze)
• Limitations: No Dify↔Coze direct connection; No iFlytek→Coze ZIP

• Purpose: Validate DSL (structure/semantic/platform)
• Required: --input/-i
• Optional: --from (auto-detected when omitted)

• Purpose: Concurrent batch conversion
• Required: --from, --to, --input-dir, --output-dir
• Optional: --pattern (default *.yml), --workers (default by CPU), --overwrite, global --quiet/--verbose

• Purpose: View capability descriptions
• Options: --nodes, --types, --all

• Purpose: View supported platforms and status
• Options: --detailed

• Purpose: Generate shell auto-completion
• Bash: agentbridge completion bash > /etc/bash_completion.d/agentbridge
• Zsh: agentbridge completion zsh > "${fpath[1]}/_agentbridge"
• PowerShell: agentbridge completion powershell | Out-String | Invoke-Expression

go fmt ./...
go vet ./...
go test ./... -cover

• Installation Issues: Ensure Go 1.21+ is installed and $GOPATH/bin is in your PATH
• Coze ZIP Auto-detection: Internally prioritized as Coze, no need for explicit --from
• Dify ↔ Coze Direct: Not supported, please relay through iFlytek
• Output Coze ZIP: Not yet supported (supports YAML; or use the fork mentioned above for YAML)
• Batch --pattern: Use quotes around patterns with special characters
• Quiet Mode: --quiet outputs only on errors

• License: See LICENSE
• Coze YAML capability reference and based on community-implemented fork: https://github.com/2064968308github/coze_transformer