agentx-python 0.8.13__py3-none-any.whl → 0.8.14__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.
@@ -13,7 +13,7 @@ Usage::
13
13
 
14
14
  Works with both ``anthropic.Anthropic`` and ``anthropic.AsyncAnthropic`` clients.
15
15
 
16
- Requires: ``pip install agentx[anthropic]``
16
+ Requires: ``pip install "agentx-python[anthropic]"``
17
17
  """
18
18
  from __future__ import annotations
19
19
 
@@ -14,7 +14,7 @@ Or as a context manager around your own kickoff::
14
14
  result = crew.kickoff(inputs={"topic": "AI"})
15
15
  span.output = result.raw
16
16
 
17
- Requires: ``pip install agentx[crewai]``
17
+ Requires: ``pip install "agentx-python[crewai]"``
18
18
  """
19
19
  from __future__ import annotations
20
20
 
agentx/version.py CHANGED
@@ -1,7 +1,7 @@
1
- VERSION = "0.8.13"
1
+ VERSION = "0.8.14"
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.7"
7
+ ENGINE_VERSION = "v0.3.10"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: agentx-python
3
- Version: 0.8.13
3
+ Version: 0.8.14
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
@@ -8,7 +8,7 @@ Author-email: contact@agentx.so
8
8
  Classifier: Programming Language :: Python :: 3
9
9
  Classifier: License :: OSI Approved :: Apache Software License
10
10
  Classifier: Operating System :: OS Independent
11
- Requires-Python: >=3.6
11
+ Requires-Python: >=3.9
12
12
  Description-Content-Type: text/markdown
13
13
  License-File: LICENSE
14
14
  Requires-Dist: urllib3>=1.26.11
@@ -50,6 +50,7 @@ Requires-Dist: litellm>=1.0.0; extra == "all"
50
50
  Requires-Dist: llama-index-core>=0.10.0; extra == "all"
51
51
  Requires-Dist: autogen-agentchat>=0.4.0; extra == "all"
52
52
  Requires-Dist: autogen-core>=0.4.0; extra == "all"
53
+ Requires-Dist: mlflow>=3.6.0; extra == "all"
53
54
  Dynamic: author
54
55
  Dynamic: author-email
55
56
  Dynamic: classifier
@@ -109,12 +110,14 @@ pip install --upgrade agentx-python
109
110
 
110
111
  Requires Python 3.9 or newer.
111
112
 
112
- #### Run self host eval framework locally
113
+ #### Run the self-host governance suite locally
113
114
 
114
- ```
115
- agentx-trace-eval --dev --update
115
+ ```bash
116
+ agentx-trace-eval --dev
116
117
  ```
117
118
 
119
+ (See [Self-host](#self-host) below for what this downloads and how to point the SDK at it.)
120
+
118
121
  ---
119
122
 
120
123
  ## Quick start
@@ -137,7 +140,7 @@ report = (
137
140
  .analyze()
138
141
  )
139
142
 
140
- print(report.average_rating) # LLM-graded score, 0–10
143
+ print(report.average_rating) # LLM-graded score, 0-10
141
144
  print(report.summary) # AI-generated narrative from .analyze()
142
145
  ```
143
146
 
@@ -158,9 +161,9 @@ report = (
158
161
  .analyze()
159
162
  )
160
163
 
161
- print(report.average_rating) # LLM-graded score, 0–10
162
- print(report.cosine_similarity) # embedding cosine, 0–1 (None if not enabled)
163
- print(report.jaccard_similarity) # token-set overlap, 0–1 (None if not enabled)
164
+ print(report.average_rating) # LLM-graded score, 0-10
165
+ print(report.cosine_similarity) # embedding cosine, 0-1 (None if not enabled)
166
+ print(report.jaccard_similarity) # token-set overlap, 0-1 (None if not enabled)
164
167
 
165
168
  print(report.summary) # AI-generated narrative from .analyze()
166
169
  print(report.recommendations) # list of prioritized, actionable fixes
@@ -184,7 +187,7 @@ client.evaluations.run(
184
187
 
185
188
  See [Prompt registry](EVALUATIONS.md#prompt-registry) in the full guide, or [self-host's docs](https://docs.agentx.so/improve/prompt-management) for the "Suggest improvement" dashboard flow (self-host only - no hosted-SaaS equivalent yet).
186
189
 
187
- On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns an exit code - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
190
+ On self-host, a finalized run can also **gate a CI job**: `run.gate(fail_under=7, no_regression=True)` (on the run context `.execute()` returns) checks the run's average rating against an absolute floor and/or the dataset's previous run, prints per-check verdicts into the CI log, and returns a `GateResult` - `sys.exit(gate.exit_code)` blocks the merge on regression. Recorded gates appear in the dashboard's CI Gates tab. See [self-host's CI docs](https://docs.agentx.so/integrations/self-host-ci) for the GitHub Actions recipe.
188
191
 
189
192
  See **[EVALUATIONS.md](EVALUATIONS.md)** for the full guide - dataset builder, framework adapters, similarity metrics, smoke testing, judge configuration, prompt registry, and the complete API reference.
190
193
 
@@ -252,6 +255,10 @@ extra:
252
255
  | LlamaIndex | `pip install "agentx-python[llamaindex]"` | `AgentXLlamaIndexHandler` |
253
256
  | AutoGen | `pip install "agentx-python[autogen]"` | `AgentXAutoGenObserver` |
254
257
 
258
+ Two more platforms are covered by **pull importers** rather than in-process hooks, each with its
259
+ own CLI: `agentx-moveworks` (Moveworks Data API sync, no extra needed) and `agentx-databricks`
260
+ (`pip install "agentx-python[databricks]"`, MLflow/Databricks trace sync).
261
+
255
262
  Or plain Python - wrap any function with `@tracer.trace(...)` and it just works, no framework
256
263
  required. Tracing is **platform agnostic**: each integration stamps its platform label
257
264
  automatically, a plain trace auto-detects the one orchestration framework imported in the
@@ -292,12 +299,14 @@ for signal in client.monitor.signals.list(severity="high"):
292
299
  print(signal.summary, signal.occurrence_count)
293
300
  ```
294
301
 
295
- Per-agent coverage/threshold settings (sample rate, retention, and threshold overrides like the built-in "Latency regression" pattern's threshold) are `client.monitor.profile.get()`/`.update()`:
302
+ Per-agent monitoring settings (enable/disable, detection categories, notification channels) are `client.monitor.profile.get()`/`.update()`:
296
303
 
297
304
  ```python
298
- client.monitor.profile.update("agent_123", threshold_overrides={"latencyMs": 15000})
305
+ client.monitor.profile.update("agent_123", info_detection_enabled=False)
299
306
  ```
300
307
 
308
+ On self-host, coverage mode, sample rate, retention, and the built-in latency threshold are project-level defaults set in the dashboard's Platform Settings; `update()` still accepts them for wire compatibility, but only the per-agent fields above take effect there.
309
+
301
310
  Self-host also has **online evaluators**: a real LLM judge scoring a sample of live traffic continuously, distinct from a pattern's rule-matching. A score below `alert_threshold` raises a signal the same way a failing pattern does, deduped and triage-ready in `client.monitor.signals`.
302
311
 
303
312
  ```python
@@ -371,7 +380,7 @@ export AGENTX_API_BASE_URL=http://localhost:4700/api/v1
371
380
  export AGENTX_API_KEY=<printed by agentx-trace-eval on first run>
372
381
  ```
373
382
 
374
- `agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. See that repo's README for what's included, and `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
383
+ `agentx-trace-eval` isn't this SDK's own code - the engine itself is a separate, compiled binary, downloaded on demand rather than bundled into this package, so installing `agentx-python` doesn't get any heavier for the (much more common) case of just talking to the hosted AgentX API. Each SDK release pins the engine release it was tested against and converges the install to that pin, so upgrading the SDK upgrades the engine too. Two flags to know: `--update` (consumed by this launcher) force-reinstalls the resolved engine release, while `--upgrade` passes through to `agentx-server` and re-downloads the dashboard bundle before serving. See that repo's README for what's included, and the `AGENTX_INSTALL_DIR`/`AGENTX_TRACE_EVAL_VERSION`/`AGENTX_TRACE_EVAL_SKIP_WEB` env vars to control where/what it installs.
375
384
 
376
385
  ---
377
386
 
@@ -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=h93nyZEahmg-F_qXioTJhKMFmXgzcYA3exV9z2on3LQ,365
13
+ agentx/version.py,sha256=ZCO46jAagFLJA2FF86tnlc0_wrjWmgCjw4xXMTEaj3w,366
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
@@ -29,9 +29,9 @@ agentx/evaluations/adapters/precomputed.py,sha256=vxnQELmpiU2NkQATfiVjG7v1ZmmkrE
29
29
  agentx/evaluations/adapters/raw.py,sha256=FkDq_mdf21-xt5EHnGyIGcS6VZxkEkFcmM9VTd-T5sA,1130
30
30
  agentx/integrations/__init__.py,sha256=W-EcQhHE01-SGPeKTB2AgfvUyRzNP4BqUMMtP2qQ4Q0,647
31
31
  agentx/integrations/_traced_call.py,sha256=O6f8HKRHDfFwoUIZDtvENVsv_OsHwzuyPMbzBakKVdo,6662
32
- agentx/integrations/anthropic.py,sha256=HNFiwtljfWsAJOmc2XXseKSVb8ThUr6BZ6CWT7uGv18,10383
32
+ agentx/integrations/anthropic.py,sha256=Fdt1bVBKYuhUa8S4nsZLNqg4REUzaZsh-7RXEWuJ-0g,10392
33
33
  agentx/integrations/autogen.py,sha256=cZryUl45Sdr9t1ba4tkz45XfkvjCud1hPp6pV0auKy8,8863
34
- agentx/integrations/crewai.py,sha256=AMxAP2Rpdojf2iaMVNcs8_LhnUGJnsS1NaX-w-1Gicc,10703
34
+ agentx/integrations/crewai.py,sha256=Ofid_YvIFYFoN12_gA3PjKAhlJgPNUh9sNyIbBcRkZs,10712
35
35
  agentx/integrations/databricks.py,sha256=vKXnur-LWMTzctFuIKte2N826sydXVlpi1qFXo2dfio,18044
36
36
  agentx/integrations/google_adk.py,sha256=swLpAfkuL2m1VZUSf_3ImwsrcTSxVdS5EIKRu2Tf4R4,12476
37
37
  agentx/integrations/google_genai.py,sha256=2patIdgyjEEW70FLP7ng4hcnFY-p0a1jPi1Pof28KBo,13272
@@ -64,9 +64,9 @@ agentx/tracing/eval_scope.py,sha256=ElMbPxpqpQBVuaUnHNlw9RIQu71oyOpd0yR55bDH8eI,
64
64
  agentx/tracing/framework_detect.py,sha256=uV4O7Th-4_2UkdooAyaWCOIA0jwLJbblFQ_ucFDjeJM,2638
65
65
  agentx/tracing/ingest_client.py,sha256=spnm6bV3NXGuj2w7HwdKiJdKDJWRUFmSP3jl3rcGqkQ,18202
66
66
  agentx/tracing/tracer.py,sha256=TxY6zG6hbM81jpfrqP4imaEvoyy_hnJVUSTnoAVHMG0,56240
67
- agentx_python-0.8.13.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
68
- agentx_python-0.8.13.dist-info/METADATA,sha256=cit9iBc_TXXOlcp8AObpzlXdbx3FLuaVTbBsBdggcJ8,21154
69
- agentx_python-0.8.13.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
70
- agentx_python-0.8.13.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
71
- agentx_python-0.8.13.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
72
- agentx_python-0.8.13.dist-info/RECORD,,
67
+ agentx_python-0.8.14.dist-info/licenses/LICENSE,sha256=gZVsM-nLsE8vlaY6NXXsVoo6IlCClxkToAWmhgT3y_s,10762
68
+ agentx_python-0.8.14.dist-info/METADATA,sha256=OT_i-6ZVjbcRjixhnL6vfo8wLdtmmkXhrjuxiEY1iRc,22117
69
+ agentx_python-0.8.14.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
70
+ agentx_python-0.8.14.dist-info/entry_points.txt,sha256=rQqF1JTY3T1yfviBU1r8PU-5mBdfOk6P4bZ1L4BskIM,172
71
+ agentx_python-0.8.14.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
72
+ agentx_python-0.8.14.dist-info/RECORD,,