[bot] Instrument Z.AI Java SDK (34,271 weekly downloads)
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 3-5 jours
- Accessibilité débutants
- 45/100
- Type d'issue
- Fonctionnalité
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- java
- Domaine
- backend, observability
Piste de recherche
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.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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/*
- Langage dominant
- Java
- Étoiles
- 21
- Forks
- 5
- Merge moyen
- 18 h 29 min
- PR mergées (30 j)
- 8
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de braintrustdata/braintrust-sdk-java
-
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
-
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100
-
Difficulté 4/5 3-5 jours Accessibilité débutants 55/100
-
Difficulté 4/5 3-5 jours Accessibilité débutants 38/100
Toutes les issues de braintrustdata/braintrust-sdk-java
Issues similaires
-
enhancement
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
-
Ctrl + w should close dialogsOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 61/100
Les mainteneurs répondent en général sous 1 jour
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
ReChronoRain/HyperCeiler#1743 ·
Les mainteneurs répondent en général sous 6 jours
-
Create CONTRIBUTING.mdOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
ControlSystemStudio/phoebus#3979 ·
Les mainteneurs répondent en général sous 2 jours
-
Cannot find symbol CTypedefPeut-être pris @pellico l’a pris aujourd’hui. Ouvertebug
Difficulté 1/5 Moins d'une heure Accessibilité débutants 82/100