Examples

Complete agent configuration and governance examples.

Example 1: Code Review Agent

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
  "agentId": "code-reviewer",
  "name": "Code Review Agent",
  "role": "R-AA",
  "sponsor": "R-DS:jane.doe",
  "baseModel": "GPT-4",
  "promptTemplate": "Review this code for quality:\n{{code}}\n\nStandards:\n{{standards}}",
  "contextSources": [
    {
      "sourceType": "knowledgeGraph",
      "query": "MATCH (s:Standard) WHERE s.domain = $domain RETURN s",
      "injectionPoint": "{{standards}}"
    }
  ],
  "skills": [
    {
      "skillId": "review-code",
      "description": "Review code quality",
      "metadata": { "requires_approval": false }
    },
    {
      "skillId": "suggest-fix",
      "description": "Suggest code fix",
      "metadata": { "requires_approval": true }
    }
  ]
}

Example 2: PM-Agent with CMMN

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{
  "agentId": "pm-agent-001",
  "name": "Project Manager Agent",
  "role": "R-AA",
  "sponsor": "R-DS:project-lead",
  "baseModel": "Claude",
  "promptTemplate": "Manage case {{caseId}}. Current stage: {{stage}}. Tasks: {{tasks}}",
  "contextSources": [
    {
      "sourceType": "caseManagement",
      "query": "GET /cases/$caseId",
      "injectionPoint": "{{case}}"
    }
  ],
  "skills": [
    {
      "skillId": "evaluate-sentry",
      "description": "Evaluate stage entry/exit sentries"
    },
    {
      "skillId": "assign-task",
      "description": "Assign task to team member",
      "metadata": { "requires_approval": true }
    }
  ],
  "governance": {
    "hitl_for_assignments": true,
    "audit_all_actions": true
  }
}

Example 3: A2A Agent Card

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
  "name": "sea-forge-specialist",
  "version": "1.0.0",
  "url": "https://sea.example.com",
  "skills": [
    {
      "id": "semantic-analysis",
      "name": "Semantic Code Analysis"
    },
    {
      "id": "artifact-generation",
      "name": "Generate CADSL Diagrams"
    },
    {
      "id": "debt-assessment",
      "name": "Assess Semantic Debt"
    }
  ],
  "authentication": {
    "schemes": ["bearer"]
  },
  "governance": {
    "authority_spec": "SDS-031",
    "requires_sponsor": true
  }
}

Example 4: Semantic Kernel Plugin

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

from semantic_kernel import Kernel
from semantic_kernel.functions import kernel_function

class SemanticDebtPlugin:
    @kernel_function(
        name="assess_debt",
        description="Assess semantic debt in codebase"
    )
    async def assess_debt(self, artifact_id: str) -> dict:
        # Read-only, no HITL required
        return await self.debt_service.assess(artifact_id)

    @kernel_function(
        name="accept_debt",
        description="Accept semantic debt item",
        metadata={"requires_approval": True}  # HITL required
    )
    async def accept_debt(
        self,
        debt_id: str,
        rationale: str,
        expiration_days: int
    ) -> dict:
        return await self.debt_service.accept(
            debt_id, rationale, expiration_days
        )

kernel = Kernel()
kernel.add_plugin(SemanticDebtPlugin(), "debt")

Last Updated: January 2026