Class TeamDescription

java.lang.Object
com.oracle.database.selectai.model.agent.TeamDescription

public final class TeamDescription extends Object
Database-generated description of a Select AI Agent team.

The documented team name, description, and version are exposed as typed values. The A2A-compatible skills representation is returned as JSON so fields introduced by a newer database release are not lost. Non-null responses must contain a single valid JSON object; malformed responses are rejected rather than represented as empty metadata. Additional fields are tolerated, and absent optional fields remain null.

This class inherits Object.toString() so ordinary object logging does not include team metadata. Use the accessors explicitly when metadata is needed, and review it before logging.

Since:
1.1.0
See Also:
  • Constructor Details

    • TeamDescription

      public TeamDescription(String rawJson)
      Creates a team description.
      Parameters:
      rawJson - database-generated team description
      Throws:
      IllegalArgumentException - when a non-null response is not a JSON object
  • Method Details

    • fromRawJson

      public static TeamDescription fromRawJson(String rawJson)
      Creates a description from a database value.
      Parameters:
      rawJson - database-generated description
      Returns:
      description, or null when the database returned no value
      Throws:
      IllegalArgumentException - when a non-null response is not a JSON object
    • getTeamName

      public String getTeamName()
      Returns the team name reported by the database.
      Returns:
      team name, or null when it was not present
    • getDescription

      Returns the team description reported by the database.
      Returns:
      team description, or null when it was not present
    • getVersion

      public String getVersion()
      Returns the optional team version reported by the database.
      Returns:
      team version, or null when not present
    • getSkills

      public String getSkills()
      Returns the A2A-compatible skills JSON exposed by the team.
      Returns:
      skills JSON, or null when the response has no skills