Home

Next

A modern Java SDK for building AI agents with OpenAI's API, similar to the TypeScript OpenAI Agents SDK, following its public API and implementation patterns where possible.

Built on the OpenAI Java SDK.

Features

  • Agents: Build conversational AI agents with OpenAI models
  • Tool Calling: Define custom tools that agents can invoke
  • Multi-Agent Handoffs: Transfer conversations between specialized agents
  • Memory Management: Built-in session management with multiple backends
  • Distributed Tracing: OpenTelemetry-compatible tracing with OpenAI platform integration
  • Guardrails: Input/output validation and safety controls
  • Streaming: Real-time streaming of agent responses

Example

<dependency>
    <groupId>ai.acolite</groupId>
    <artifactId>openai-agent-sdk</artifactId>
    <version>0.4.0</version>
</dependency>

implementation 'ai.acolite:openai-agent-sdk:0.4.0'

import ai.acolite.agentsdk.core.Agent;
import ai.acolite.agentsdk.core.RunResult;
import ai.acolite.agentsdk.core.Runner;
import ai.acolite.agentsdk.core.types.TextOutput;
import ai.acolite.agentsdk.core.types.UnknownContext;

public class Example {
  public static void main(String[] args) {
    Agent<UnknownContext, TextOutput> agent =
        Agent.<UnknownContext, TextOutput>builder()
            .name("Assistant")
            .instructions("You are a helpful assistant.")
            .build();

    RunResult<UnknownContext, ?> result =
        Runner.run(agent, "Write a haiku about recursion in programming.");

    System.out.println(result.getFinalOutput());
  }
}

Getting Started

New to the SDK? Start with the Quickstart guide to build your first agent.

Guides

Learn how to use specific features:

  • Agents - Creating and configuring agents
  • Tools - Defining custom tools
  • Handoffs - Multi-agent workflows
  • Sessions - Memory and conversation history
  • Tracing - Observability and debugging

Requirements

  • Java 21 or higher
  • Maven 3.6+ or Gradle 7+
  • OpenAI API key (Get one here)

Installation

Add to your pom.xml:

<dependency>
    <groupId>ai.acolite</groupId>
    <artifactId>openai-agent-sdk</artifactId>
    <version>0.4.0</version>
</dependency>

Support

Quickstart