[bot] Instrument Z.AI Java SDK (34,271 weekly downloads)
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 45/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- java
- Ambito
- backend, observability
Direzione di ricerca
Read AGENTS.md and compare the existing modules under braintrust-sdk/instrumentation/*, especially their build.gradle files. Then inspect the upstream zai-org/z-ai-sdk-java client APIs and the repository’s instrumentation patterns. Done means the Java SDK’s relevant Z.AI calls are traced and covered by tests; the issue does not identify specific entry points or tests.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Summary
Z.AI (formerly Zhipu AI, makers of the GLM model family) publishes an official Java SDK, zai-org/z-ai-sdk-java, distributed on Maven Central as ai.z.openapi:zai-sdk. It exposes a dedicated client (ZaiClient / ZhipuAiClient) for execution-oriented generative AI calls — chat completions (sync + streaming), function/tool calling, embeddings, vision, image generation, video generation, and speech. This SDK is not covered by any existing instrumentation module in this repo, and its client classes are entirely distinct from the com.openai/com.anthropic/dev.langchain4j/Spring AI/Bedrock/Google GenAI classes already instrumented, so none of today's bytecode instrumentation applies to it.
What is missing
| Capability | Upstream (ai.z.openapi:zai-sdk) |
Braintrust Java SDK instrumentation |
|---|---|---|
| Chat completions (sync) | ✅ ChatCompletionService |
❌ not instrumented |
| Streaming chat completions | ✅ Flowable-based streaming |
❌ not instrumented |
| Function / tool calling | ✅ | ❌ not instrumented |
| Embeddings | ✅ | ❌ not instrumented |
| Vision / multimodal | ✅ | ❌ not instrumented |
| Image / video generation | ✅ | ❌ not instrumented |
None of braintrust-sdk/instrumentation/* targets the ai.z.openapi group — the directory currently contains only anthropic_2_2_0, aws_bedrock_2_30_0, genai_1_18_0, langchain_1_14_0, langchain_1_8_0, openai_2_15_0, springai_1_0_0, and springai_2_0_0.
Weekly downloads
Maven Central does not publish public per-artifact download counts, so per this repo's established precedent (e.g. #162) the primary tracked distribution for this SDK family is cited instead: the official Python package zai-sdk on PyPI had 34,271 downloads in the last 7 days, as of 2026-10-19, per pypistats.org (https://pypistats.org/api/packages/zai-sdk/recent → {"last_week": 34271}; corroborated by the daily overall series at https://pypistats.org/api/packages/zai-sdk/overall covering 2026-04-08–2026-10-18).
Braintrust docs status
Checked braintrust.dev/docs/admin/ai-providers: Braintrust lists OpenAI, Anthropic, Google Vertex AI, Azure AI Foundry, Bedrock, and custom providers as configurable AI providers. GLM (Z.AI's model family) appears only as a Braintrust-hosted built-in model (GLM-5.2, GLM-5.3 Flash, served via Baseten through the Braintrust gateway using an OpenAI-compatible endpoint) — there is no direct Z.AI/Zhipu provider integration or SDK-instrumentation guidance. A user calling Z.AI's own API directly via the official zai-sdk Java client (rather than routing through Braintrust's gateway with the OpenAI SDK) gets no tracing today.
Upstream sources
- SDK repo: https://github.com/zai-org/z-ai-sdk-java
- Official docs: https://docs.z.ai/guides/develop/java/introduction
- Maven Central: https://central.sonatype.com/artifact/ai.z.openapi/zai-sdk (latest
0.3.5; active release cadence from0.0.6through0.3.5across 2025–2026)
Braintrust docs sources
- https://www.braintrust.dev/docs/admin/ai-providers
- https://braintrust.dev/blog/glm-52-vs-opus-48-technical-report
Local files inspected
AGENTS.mdbraintrust-sdk/instrumentation/*/build.gradle(anthropic_2_2_0, aws_bedrock_2_30_0, genai_1_18_0, langchain_1_14_0, langchain_1_8_0, openai_2_15_0, springai_1_0_0, springai_2_0_0)- Directory listing of
braintrust-sdk/instrumentation/*
- Lingua principale
- Java
- Stelle
- 21
- Fork
- 5
- Merge medio
- 18h 29m
- PR unite (30g)
- 8
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di braintrustdata/braintrust-sdk-java
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 35/100
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 55/100
-
Difficoltà 4/5 3-5 giorni Idoneità per principianti 38/100
Tutte le issue di braintrustdata/braintrust-sdk-java
Issue simili
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 75/100
521xueweihan/HelloGitHub#4105 ·
-
Awaiting further input from submitter
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
I maintainer di solito rispondono entro 1 giorno
-
code-maintenance
Difficoltà 2/5 1-3 ore Idoneità per principianti 80/100
I maintainer di solito rispondono entro 1 giorno