Package com.xebialabs.xlrelease.a2a.api

Annotation Interface A2aSkill

@Retention(RUNTIME) @Target(METHOD) public @interface A2aSkill
Marks a method on an A2aSkillset bean as one A2A skill. See A2aSkillset for the required method signature and execution contract.

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    description
    What the skill does and what input it expects — agents read this to decide what to send.
    String
    id
    Skill id as advertised on the Agent Card and addressed via message metadata skillId.
    String
    name
    Human-readable name for the Agent Card.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    boolean
    readOnly
    Whether the skill only reads Release state.

  • Element Details

    • id

      String id
      Skill id as advertised on the Agent Card and addressed via message metadata skillId. Must be unique across all skills, built-in and contributed; a duplicate is logged and the contribution skipped.

    • name

      String name
      Human-readable name for the Agent Card.

    • description

      String description
      What the skill does and what input it expects — agents read this to decide what to send.

    • readOnly

      boolean readOnly
      Whether the skill only reads Release state. When the A2A feature's read-only mode is on, skills declaring false are hidden from the Agent Card and rejected if called anyway. Defaults to true — a skill must opt in to mutating.
      Default:
      true