Embabel Agent Common

Foundational AI framework utilities for the Embabel Agent system providing abstractions for LLMs, structured output conversion, streaming, and embedding services.

Installation

Maven:

<dependency>
    <groupId>com.embabel.agent</groupId>
    <artifactId>embabel-agent-common</artifactId>
    <version>0.3.3</version>
</dependency>

Gradle:

implementation("com.embabel.agent:embabel-agent-common:0.3.3")

Quick Start

import com.embabel.common.ai.model.LlmOptions
import com.embabel.common.ai.converters.JacksonOutputConverter

// Configure LLM
val options = LlmOptions.withModel("gpt-4").withTemperature(0.7)

// Parse structured output
data class Person(val name: String, val age: Int)
val converter = JacksonOutputConverter(Person::class.java, ObjectMapper())
val person = converter.convert(llmResponse)

Documentation Structure

Quick Reference: Task-oriented lookup →

Core APIs: Essential functionality for most use cases

• Model Configuration → - LLM options and model selection
• Output Converters → - Structured output parsing
• Streaming → - Reactive JSONL streaming

Supporting APIs: Additional functionality

• Model Metadata → - Model information and capabilities
• Pricing → - Cost calculation
• Prompt System → - Dynamic prompt construction
• Auto-Configuration → - YAML-based model loading
• Embedding Services → - Text embedding abstractions

Advanced Topics:

• Error Handling → - Exception types and recovery
• Integration Patterns → - Spring and reactive patterns
• Performance → - Optimization and best practices

Reference: Complete type information

• Types → - All interfaces and data classes