agentx-python 0.8.10__py3-none-any.whl → 0.8.12__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -428,6 +428,15 @@ class IngestClient:
428
428
  continue
429
429
 
430
430
  if resp.status_code in _RETRYABLE_STATUS and attempt < _MAX_RETRIES - 1:
431
+ # 429 = the engine's bounded ingest queue shedding load (its ADR-0005): honor
432
+ # Retry-After exactly instead of the generic backoff schedule, so the SDK backs
433
+ # off in step with the server's own flush cadence.
434
+ retry_after = resp.headers.get("Retry-After")
435
+ if resp.status_code == 429 and retry_after:
436
+ try:
437
+ time.sleep(min(30.0, float(retry_after)))
438
+ except ValueError:
439
+ pass
431
440
  last_exc = Exception(f"HTTP {resp.status_code}")
432
441
  continue
433
442
  if not resp.ok:
agentx/version.py CHANGED
@@ -1,7 +1,7 @@
1
- VERSION = "0.8.10"
1
+ VERSION = "0.8.12"
2
2
 
3
3
  # The AgentX-trace-eval release this SDK version is tested against - what `agentx-trace-eval`
4
4
  # installs and converges to (see agentx/cli.py). Bump together with VERSION when releasing, so
5
5
  # every published SDK names a known-good engine+dashboard pair. Users can override with
6
6
  # AGENTX_TRACE_EVAL_VERSION=<tag|latest>.
7
- ENGINE_VERSION = "v0.3.1"
7
+ ENGINE_VERSION = "v0.3.4"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agentx-python
3
- Version: 0.8.10
3
+ Version: 0.8.12
4
4
  Summary: Official Python SDK for AgentX (https://www.agentx.so/)
5
5
  Home-page: https://github.com/AgentX-ai/AgentX-python
6
6
  Author: Robin Wang and AgentX Team
@@ -68,7 +68,7 @@ Dynamic: summary
68
68
  [![Python versions](https://img.shields.io/pypi/pyversions/agentx-python)](https://pypi.org/project/agentx-python/)
69
69
  [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
70
70
 
71
- The official Python SDK for **[AgentX](https://app.agentx.so/)** - an evaluation, tracing, and monitoring framework for AI agents, plus a client for AgentX's own hosted agents.
71
+ The official Python SDK for **[AgentX](https://www.agentx.so/)** - an evaluation, tracing, and monitoring framework for AI agents, plus a client for AgentX's own hosted agents.
72
72
 
73
73
  Also see [SDK Developer Docs](https://developers.agentx.so), [API Reference Docs](https://docs.agentx.so/reference)
74
74
 
@@ -109,19 +109,10 @@ pip install --upgrade agentx-python
109
109
 
110
110
  Requires Python 3.9 or newer.
111
111
 
112
- ---
113
-
114
- ## Authentication
115
-
116
- Get your API key at [app.agentx.so](https://app.agentx.so), then either pass it inline or expose it as an environment variable.
117
-
118
- ```python
119
- # Option A - pass the key inline
120
- from agentx import AgentX
121
- client = AgentX(api_key="your-api-key-here")
112
+ #### Run self host eval framework locally
122
113
 
123
- # Option B - set AGENTX_API_KEY in your environment, then:
124
- client = AgentX.from_env()
114
+ ```
115
+ agentx-trace-eval --dev --update
125
116
  ```
126
117
 
127
118
  ---
@@ -179,7 +170,7 @@ print(report.recommendations) # list of prioritized, actionable fixes
179
170
 
180
171
  Ask a case's question several extra ways each run, LLM-paraphrased server-side, to catch agents that break on phrasing rather than substance, and override the judge's prompt/model per config, see [Smoke testing](EVALUATIONS.md#smoke-testing-phrasing-robustness) and [Configuring the judge](EVALUATIONS.md#configuring-the-judge) in the full guide.
181
172
 
182
- Since AgentX doesn't own your agent's code, `client.evaluations.prompts` lets AgentX become your prompt's *source of truth* instead - the same problem LangSmith's Prompt Hub and Langfuse's Prompt Management solve. Pull a version at runtime, tag your eval runs (or live traces) with it, and let a judge propose a rewrite from your real worst-rated results - a human always has to approve before it publishes:
173
+ Since AgentX doesn't own your agent's code, `client.evaluations.prompts` lets AgentX become your prompt's _source of truth_ instead - the same problem LangSmith's Prompt Hub and Langfuse's Prompt Management solve. Pull a version at runtime, tag your eval runs (or live traces) with it, and let a judge propose a rewrite from your real worst-rated results - a human always has to approve before it publishes:
183
174
 
184
175
  ```python
185
176
  prompt = client.evaluations.prompts.get("support-agent-system-prompt") # or prompt.id
@@ -248,18 +239,18 @@ regular totals, no extra config needed. Self-host's cost estimate prices these s
248
239
  regular input token when you've set optional cache rates on that model. Install the matching
249
240
  extra:
250
241
 
251
- | Framework | Install | Integration |
252
- | --------------------- | -------------------------------------------- | ------------------------ |
253
- | LangChain | `pip install "agentx-python[langchain]"` | `AgentXCallbackHandler` |
254
- | CrewAI | `pip install "agentx-python[crewai]"` | `AgentXCrewObserver` |
255
- | OpenAI Agents SDK | `pip install "agentx-python[openai-agents]"` | `AgentXTracingProcessor` |
256
- | OpenAI (raw client) | `pip install "agentx-python[openai]"` | `patch_openai_client` |
257
- | Anthropic | `pip install "agentx-python[anthropic]"` | `patch_anthropic_client` |
258
- | Google ADK | `pip install "agentx-python[google-adk]"` | `AgentXADKPlugin` |
259
- | Google GenAI (Gemini) | `pip install "agentx-python[google-genai]"` | `patch_genai_client` |
260
- | LiteLLM | `pip install "agentx-python[litellm]"` | `AgentXLiteLLMLogger` |
261
- | LlamaIndex | `pip install "agentx-python[llamaindex]"` | `AgentXLlamaIndexHandler`|
262
- | AutoGen | `pip install "agentx-python[autogen]"` | `AgentXAutoGenObserver` |
242
+ | Framework | Install | Integration |
243
+ | --------------------- | -------------------------------------------- | ------------------------- |
244
+ | LangChain | `pip install "agentx-python[langchain]"` | `AgentXCallbackHandler` |
245
+ | CrewAI | `pip install "agentx-python[crewai]"` | `AgentXCrewObserver` |
246
+ | OpenAI Agents SDK | `pip install "agentx-python[openai-agents]"` | `AgentXTracingProcessor` |
247
+ | OpenAI (raw client) | `pip install "agentx-python[openai]"` | `patch_openai_client` |
248
+ | Anthropic | `pip install "agentx-python[anthropic]"` | `patch_anthropic_client` |
249
+ | Google ADK | `pip install "agentx-python[google-adk]"` | `AgentXADKPlugin` |
250
+ | Google GenAI (Gemini) | `pip install "agentx-python[google-genai]"` | `patch_genai_client` |
251
+ | LiteLLM | `pip install "agentx-python[litellm]"` | `AgentXLiteLLMLogger` |
252
+ | LlamaIndex | `pip install "agentx-python[llamaindex]"` | `AgentXLlamaIndexHandler` |
253
+ | AutoGen | `pip install "agentx-python[autogen]"` | `AgentXAutoGenObserver` |
263
254
 
264
255
  Or plain Python - wrap any function with `@tracer.trace(...)` and it just works, no framework required.
265
256
 
@@ -10,7 +10,7 @@ agentx/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
10
10
  agentx/testing.py,sha256=0shZEid_vhJgBegpO_loUq6APYDxQrUgD3jvcRdIDV8,7372
11
11
  agentx/traces.py,sha256=sz9gxutlDKNgf0fdCkyzKsGwK5eMAJuIEl3NIwGrsuo,2287
12
12
  agentx/util.py,sha256=lt2Kpg4Fj8whrSuAhLEahcPEIYRVpK9RCC5y9ShdTJs,703
13
- agentx/version.py,sha256=sSbsfDvIXz3zR_dv_mmgv3XPzX8Fi8FnwzRLQ-G08M8,365
13
+ agentx/version.py,sha256=vsrbVEe8EC1S6DCr1jnhCYco-1GCWOHdaUPGulZoMR0,365
14
14
  agentx/evaluations/__init__.py,sha256=Erv7RGFlRxGTG4rVb2uHhCqLLEX_iAWKqkZKzK6CumE,262
15
15
  agentx/evaluations/_term.py,sha256=WFpiNzdgDBeJJ-Gg-6X7TwwxllobuE4OqFUTuDQvS3Y,2529
16
16
  agentx/evaluations/client.py,sha256=UlYl8OFmIjk8oqmL_LEpjnTn6CmUPBM1kgVgzkUKfT8,31999
@@ -61,11 +61,11 @@ agentx/resources/workforce.py,sha256=lfGVkoV9lcOp-lZScjTvwRarJMkhzfMfLm4syJDujGc
61
61
  agentx/tracing/__init__.py,sha256=l2mIRILE-wWrCD0fekgrIOQUEvtDObzdrkgpQUtXroU,408
62
62
  agentx/tracing/ci_types.py,sha256=zFVcZGvc1qbVDdOlEPQ1i5R6terqJHxCzFF4ZjouxxI,1423
63
63
  agentx/tracing/eval_scope.py,sha256=ElMbPxpqpQBVuaUnHNlw9RIQu71oyOpd0yR55bDH8eI,2144
64
- agentx/tracing/ingest_client.py,sha256=5X6RyxtMq1XYgOzsMd3b2f2qpmYpsMnhKm7NB3oup00,17664
64
+ agentx/tracing/ingest_client.py,sha256=spnm6bV3NXGuj2w7HwdKiJdKDJWRUFmSP3jl3rcGqkQ,18202
65
65
  agentx/tracing/tracer.py,sha256=qQojU-T4O8IJKyf9vue0Em66qPBTZKl3FMyr3KJKPnI,53770
66
- agentx_python-0.8.10.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
67
- agentx_python-0.8.10.dist-info/METADATA,sha256=EzbfWsvWLIimWsfA-vHWsqV0BWRK4Emc1u1ryY_xWHU,21032
68
- agentx_python-0.8.10.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
69
- agentx_python-0.8.10.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
70
- agentx_python-0.8.10.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
71
- agentx_python-0.8.10.dist-info/RECORD,,
66
+ agentx_python-0.8.12.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
67
+ agentx_python-0.8.12.dist-info/METADATA,sha256=3uZCbOgUOxHRzbygAFJTbVulNQqgXZONs0jMig7uGYc,20768
68
+ agentx_python-0.8.12.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
69
+ agentx_python-0.8.12.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
70
+ agentx_python-0.8.12.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
71
+ agentx_python-0.8.12.dist-info/RECORD,,