API Reference

// 快速创建 — 使用默认提供商
LlmClient client = LlmKit.create("sk-xxx");

// 指定提供商 + 完整配置
LlmClient client = LlmKit
    .builder(Providers.OPENAI)
    .apiKey("sk-xxx")
    .model("gpt-4o")
    .build();

// 查看可用提供商
List<String> names = LlmKit.providers();
// → ["openai", "anthropic", "deepseek", ...]

// 一次性对话
String answer = client.chat("What is quantum computing?");

// 完整请求
ChatResponse response = client.chat(ChatRequest.builder()
    .messages(ChatMessage.user("Hello"))
    .build());
System.out.println(response.content());

LlmClient client = LlmKit
    .builder(Providers.ANTHROPIC)
    .apiKey("sk-ant-xxx")
    .model("claude-sonnet-4-20250514")
    .baseUrl("https://api.anthropic.com")
    .timeout(Duration.ofSeconds(60))
    .retry(RetryPolicy.defaults())
    .build();

client.chatStream(request, new StreamListener() {
    @Override
    public void onChunk(ChatChunk chunk) {
        System.out.print(chunk.delta());
    }

    @Override
    public void onComplete(ChatResponse response) {
        System.out.println("\nDone");
    }

    @Override
    public void onError(Throwable e) {
        e.printStackTrace();
    }
});

// 使用默认策略
RetryPolicy policy = RetryPolicy.defaults();

// 自定义策略
RetryPolicy policy = RetryPolicy.builder()
    .maxRetries(5)
    .initialDelayMs(2000)
    .backoffMultiplier(2.5)
    .maxDelayMs(60000)
    .build();

ChatRequest request = ChatRequest.builder()
    .model("gpt-4o")
    .messages(
        ChatMessage.system("You are a helpful assistant"),
        ChatMessage.user("Explain quantum computing")
    )
    .temperature(0.7)
    .maxTokens(1024)
    .responseFormat(ChatRequest.jsonResponseFormat())
    .build();

// 多轮对话
ChatRequest request = ChatRequest.builder()
    .messages(
        ChatMessage.system("You are a translator"),
        ChatMessage.user("Translate to French: Hello"),
        ChatMessage.assistant("Bonjour"),
        ChatMessage.user("Thank you")
    )
    .build();

ToolDefinition tool = ToolDefinition.builder()
    .name("get_weather")
    .description("Get current weather for a location")
    .parameters("{"type":"object"," +
        ""properties":{" +
          ""location":{"type":"string","description":"City name"}" +
        "}," +
        ""required":["location"]"})
    .build();

// 完整的 Tool Calling 流程
ChatResponse response = client.chat(request);

if (response.content() == null) {
    ToolCall call = response.getChoices().get(0)
        .getMessage().getToolCalls().get(0);

    // 执行你的工具函数...
    String result = executeTool(call.getName(), call.getArguments());

    // 将结果反馈给模型
    ChatRequest followUp = ChatRequest.builder()
        .messages(
            response.getChoices().get(0).getMessage(),
            ChatMessage.toolResult(call.getId(), result)
        )
        .build();

    ChatResponse finalResp = client.chat(followUp);
    System.out.println(finalResp.content());
}