flyteplugins-agents-core
The shared contract every Flyte agent-SDK adapter is built on, so they all follow one common format.
It is SDK-agnostic — no agent SDK is a dependency here. Adapters depend on it and
implement the contract; assert_adapter_conforms enforces that in CI.
What's in it
durable_step(request_key, run, *, name, dumps, loads)— record a call as a durable, replayableflyte.traceleaf (the model-turn durability mechanism). The real, non-serializable call is captured in therunclosure, so the trace only ever sees the serializablerequest_key.fingerprint(payload)— a deterministic memo key from a request payload.ToolTaskResolver/attach_tool_resolver(task)— make a tool-backing task resolve to itself on the worker (via the tool's__wrapped_task__hook) instead of re-dispatching, which would otherwise recurse indefinitely.ReportTimeline— render agent events into a tab of the Flyte task report.flyteplugins.agents.core.testing.assert_adapter_conforms(module)— the conformance check every adapter runs as a one-line test.
The rule every adapter follows
The agent run is a Flyte @env.task (the durable parent); each model turn
is a flyte.trace (a memoized, replayable leaf); each tool is a Flyte task
invoked as a durable child action.
Writing an adapter
A flyteplugins-agents-<sdk> package depends on this core and exposes, at
minimum, tool and run_agent (see the conformance contract). Its tool
object exposes __wrapped_task__; run_agent runs the SDK's loop inside the
calling @env.task, wraps the model in a durable provider built on durable_step,
and renders the trace via ReportTimeline.
1 maintainer
Release files for flyteplugins-agents-core 2.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| flyteplugins_agents_core-2.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / flyteplugins_agents_core-2.8.0-py3-none-any.whl
| Download URL | flyteplugins_agents_core-2.8.0-py3-none-any.whl |
|---|---|
| Size | 15.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c2d5434960ed77aaf7b826b4d22e874ae18baf323f5ad9623334e3f19e0a9e26
|
|
BLAKE2b-256 checksum How to use checksums |
1f6c6fca698cea105c0a319b74bafb76cb820510322c74516eec6b24ea278b9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
