Zen Agents Action

GitHub Action for Zencoder Agents

Authentication

Generate an API key at https://auth.zencoder.ai/api-keys and pass it as zencoder_api_key.

Note: zencoder_client_id and zencoder_client_secret are deprecated and kept for backwards compatibility only. Use zencoder_api_key for new integrations.

Workflow examples

Pull request reviews

name: Run Zencoder Agent on PR review

on:
  pull_request:
    branches:
      - main
jobs:
  agent-run:
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Running Zencoder Agent
        uses: zencoderai/zen-agents-action@main
        with:
          prompt: "Please review the pull request with number ${{ github.event.pull_request.number }} and add comment to it. Please address only the serious issues, not the minor ones. If you didn't find any serious issues, please write 'Looks good to me!'."
          zencoder_api_key: "${{ secrets.ZENCODER_API_KEY }}"
          zencoder_client_id: "${{ secrets.ZENCODER_CLIENT_ID }}"
          zencoder_client_secret: "${{ secrets.ZENCODER_CLIENT_SECRET }}"
          github_token: "${{ secrets.GITHUB_TOKEN }}"

Workflow to be triggered from API call or manually

name: Run Zencoder Agent

on:
  workflow_dispatch:
    inputs:
      prompt:
        type: string
        description: "The input prompt for the Agent"
        required: true
      agent:
        type: string
        description: "Alias of the agent to run (will run default agent if not provided)"
        required: false
        default: ""
jobs:
  agent-run:
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Running Zencoder Agent
        uses: zencoderai/zen-agents-action@main
        with:
          prompt: "${{ inputs.prompt }}"
          agent: "${{ inputs.agent }}"
          zencoder_api_key: "${{ secrets.ZENCODER_API_KEY }}"
          zencoder_client_id: "${{ secrets.ZENCODER_CLIENT_ID }}"
          zencoder_client_secret: "${{ secrets.ZENCODER_CLIENT_SECRET }}"
          github_token: "${{ secrets.GITHUB_TOKEN }}"

Inputs

Name	Type	Required	Default	Description
zencoder_api_key	String	false		Zencoder API key for authentication
zencoder_client_id	String	false		Zencoder client id (deprecated, use zencoder_api_key)
zencoder_client_secret	String	false		Zencoder client secret (deprecated, use zencoder_api_key)
github_token	String	true		GitHub token used by the action to access GitHub APIs
prompt	String	true		The input prompt for the Agent
version	String	false	"latest"	Version of the zencoder to use
agent	String	false	""	Alias of the agent to run (will run default agent if not provided)
base_path	String	false	"."	Base path to run agent from (should be repository root)
model	String	false	"default"	LLM model to use (e.g., opus-4-5, sonnet-4, gemini-25-pro). Use default for server default.