AxAgent Observability For Java
Use when writing Java code with dev.axllm:ax for agent tracing, usage accounting, action logs, runtime diagnostics, replay, and production debugging.
Install
Install only this skill for Java:
npx skills add https://ax-llm.github.io/ax/java/ --skill 'ax-java-agent-observability'Published skill file: ax-java-agent-observability/SKILL.md.
Source
- Source: packages/java/skills/ax-java-agent-observability/SKILL.md
- Version:
22.0.3
Skill Instructions
This skill helps an agent write Java code with the generated Ax package dev.axllm:ax. Use the generated package API, examples, and manifests; do not import TypeScript-only APIs unless you are editing the TypeScript package.
When To Use
- Inspect agent traces, runtime envelopes, usage, or action logs.
- Attach callbacks for model/tool activity and runtime progress.
- Debug agent loops through generated package state and examples.
Package Facts
- Language: Java.
- Package:
dev.axllm:ax. - Package API docs:
API.mdandaxir-api.json. - Capability manifest:
axir-capabilities.json. - Runnable examples:
examples/. - Real network support: yes.
- Scripted no-key transport support: yes.
- Runtime profiles:
javascript-quickjs,python-pyodide.
Core Pattern
AxAgent helper = Ax.agent("question:string -> answer:string", java.util.Map.of());
var out = helper.forward(llm, java.util.Map.of("question", "How should I proceed?"));Relevant API Surface
- Agents And RLM:
Ax.agent,AxAgent - Runtime Profiles:
ProcessCodeRuntime,RuntimeCapabilities,RuntimeEnvelope,javascript-quickjs,python-pyodide
Guardrails
- Start from package examples for exact native syntax before inventing a new call shape.
- Use
provider-apiexamples only when the user explicitly has provider credentials available. - Use
no-keyexamples for deterministic local checks and provider request mapping. - Treat AxIR as the source of generated package truth: if package docs disagree with source code, update the compiler and regenerate packages.
- Do not copy repo-maintainer skills from
tools/*/skills/into user packages.