How to Use Annotations for Google A2A protocol - vishalmysore/a2ajava GitHub Wiki

OpenAIPromptTransformer transformer = new OpenAIPromptTransformer();

// Example prompt with employee information
String promptText = "Shahrukh Khan works for MovieHits inc and his salary is $100. " +
    "He joined Toronto on Labor day, his tasks are acting and dancing. " +
    "He also works out of Montreal and Bombay. " +
    "Krithik roshan is another employee based in Chennai, his tasks are jumping and Gym, " +
    "he joined on Indian Independence Day";

// Convert to Organization object
Organization org = (Organization) transformer.transformIntoPojo(promptText, Organization.class);

// The system automatically extracts:
// - Employee names and their locations
// - Salary information
// - Join dates
// - Tasks/responsibilities
// - Multiple office locations

@Agent(groupName = "diary", groupDescription = "Personal diary management")
public class DiaryAction implements JavaMethodAction {
    @Action(description = "Record appointments and meetings")
    public DiaryEntry recordEntry(String entry) {
        // Implementation
        return new DiaryEntry(entry);
    }
}

// Usage
OpenAiActionProcessor processor = new OpenAiActionProcessor();
DiaryAction action = new DiaryAction();
String prompt = "I have a dentist appointment on July 3rd at 2 PM, " +
                "and a meeting with the team on July 5th at 10 AM";
DiaryEntry result = (DiaryEntry) processor.processSingleAction(prompt, action);

// The system automatically chooses the appropriate action
String prompt = "Schedule a team meeting for tomorrow at 3 PM";
Object result = processor.processSingleAction(prompt);

public class Organization {
    // Automatically maps employee list from text
    @ListType(Employee.class)
    private List<Employee> employees;
    
    // Handles simple string lists (e.g., office locations)
    @ListType(String.class)
    private List<String> locations;
}

public class SportSchedule {
    // Maps key-value pairs from text
    @MapKeyType(DayOfWeek.class)
    @MapValueType(String.class)
    private Map<DayOfWeek, String> schedule;
}

// Can be populated from text like:
// "Monday is for swimming, Wednesday for gym, Friday for yoga"

public class TranslationRequest {
    @Prompt(describe = "translate to Hindi")
    private String hindi;
    
    @Prompt(describe = "translate to Tamil")
    private String tamil;
    
    @Prompt(describe = "translate to Punjabi")
    private String punjabi;
}

// Usage
String text = "Hello, how are you?";
TranslationRequest translations = transformer.transformIntoPojo(text, TranslationRequest.class);
// Automatically translates to all specified languages

public class Event {
    @Prompt(
        dateFormat = "yyyy-MM-dd",
        describe = "Extract event date, use today if not specified"
    )
    private Date eventDate;
}

public class UserProfile {
    // Field will be excluded from AI processing
    @Prompt(ignore = true)
    private String sensitiveData;
    
    // Custom processing instructions
    @Prompt(describe = "Extract user's full name, capitalize each word")
    private String fullName;
}

@Agent(
    actionName = "serverRestart",
    description = "Restart the production server",
    riskLevel = ActionRisk.HIGH,
    groupName = "System Administration"
)
public class ServerAction implements JavaMethodAction {
    @Action
    public String restartServer(String reason, String approver) {
        // Implementation with safety checks
        return String.format("Server restarted by %s: %s", approver, reason);
    }
}

processor.processSingleAction("Please restart the server");

ServerAction action = new ServerAction();
processor.processSingleAction(
    "Restart server due to memory leak, approved by John Doe",
    action
);

System.setProperty("tools4ai.debug", "true");

TestHelper.validateExtraction(prompt, expectedData);

processor.setVerboseMode(true);