Step 2: Add the Action¶

Let's add the CapiscIO validation action to your GitHub repository.

Create the Workflow File¶

Create .github/workflows/validate-agent.yml:

name: Validate A2A Agent

on:
  push:
    branches: [main]
    paths:
      - 'agent-card.json'
  pull_request:
    branches: [main]
    paths:
      - 'agent-card.json'

jobs:
  validate:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Validate Agent Card
        uses: capiscio/validate-a2a@v1
        with:
          agent-card: './agent-card.json'

That's it! This workflow will:

1. Run on pushes to main that modify agent-card.json
2. Run on PRs to main that modify agent-card.json
3. Validate the agent card and report results

Test It¶

Commit and push the workflow:

git add .github/workflows/validate-agent.yml
git commit -m "Add A2A agent validation"
git push

Now make a change to your agent-card.json (or create one if you don't have it):

# Create a sample agent card
cat > agent-card.json << 'EOF'
{
  "name": "My Agent",
  "description": "A sample A2A agent",
  "url": "https://example.com/agent",
  "version": "1.0.0",
  "protocolVersion": "0.2.0",
  "provider": {
    "organization": "My Company"
  },
  "capabilities": {
    "streaming": false
  },
  "skills": [
    {
      "id": "greeting",
      "name": "Greeting",
      "description": "Returns a greeting"
    }
  ]
}
EOF

git add agent-card.json
git commit -m "Add agent card"
git push

Check the Actions tab in your GitHub repository to see the validation run!

Understanding the Output¶

When the action runs, you'll see output like:

✅ A2A AGENT VALIDATION PASSED
Score: 75/100
Version: 0.2.0
Agent passed with warnings

ISSUES FOUND:
⚠️ [MISSING_OPTIONAL_FIELD] warning: Missing recommended field 'authentication'

The action sets these outputs for use in subsequent steps:

Action Inputs¶

The action accepts these inputs:

Running on All Pushes¶

To run on every push (not just when agent-card.json changes):

name: Validate A2A Agent

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: capiscio/validate-a2a@v1
        with:
          agent-card: './agent-card.json'

Validating from URL¶

If your agent card is hosted:

- uses: capiscio/validate-a2a@v1
  with:
    agent-card: 'https://myagent.example.com/.well-known/agent-card.json'

What's Next?¶

You now have:

• GitHub Action added to your workflow
• Basic validation running on pushes and PRs

Let's configure validation thresholds!