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.6.1
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.6.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / flyteplugins_agents_core-2.6.1-py3-none-any.whl
| Download URL | flyteplugins_agents_core-2.6.1-py3-none-any.whl |
|---|---|
| Size | 15.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2cb1407260d44baef7dd81739cdca93ecb907ed3a292a6f437fc982b40704433
|
|
BLAKE2b-256 checksum How to use checksums |
66573174718446e37e28eb96d78985cf741e46d31bc00554f8122435df7ea7be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
