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
Metadata
1 maintainer
Release files for flyteplugins-agents-core 2.10.2
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.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Release files / flyteplugins_agents_core-2.10.2-py3-none-any.whl
| Download URL | flyteplugins_agents_core-2.10.2-py3-none-any.whl |
|---|---|
| Size | 15.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed46b8b7f0c6397e2f0cfe7534bc6b76bea74f39b2742d0439391eda3bdd8fec
|
|
BLAKE2b-256 checksum How to use checksums |
82152e6f19fe08007e3479eea58e0223b5dc48b67de0b9a14a08b1e87a1f7659
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
