andre/crewAI
1
0
Fork 0
mirror of https://github.com/crewAIInc/crewAI.git synced 2026-07-02 13:48:09 +00:00
Code Issues Actions 6 Packages Projects Releases Wiki Activity

docs: note FileArtifact handles are run-scoped and don't survive across runs

Browse Source
This commit is contained in:
Matt Aitchison
2026-06-04 20:38:52 -05:00
parent ad798afeca
commit 0fba8163ca
1 changed files with 6 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
lib/crewai/src/crewai/tools/file_artifact.py
View File

@@ -16,6 +16,12 @@ The handle is namespaced (``crewai+file://``) so resolution only ever fires on
tokens this module minted, never on arbitrary user data. Stored bytes are scoped
to a crew/task execution id and cleared when that execution finishes; a TTL prune
is the safety net for runs that never call :func:`clear_artifact_scope`.
Limitation: handles are ephemeral and scoped to a single run. A handle only
resolves while its run's artifacts are live. If a placeholder's text is persisted
(conversation memory, a checkpoint) and a *later* run echoes that handle, it will
no longer resolve and the literal token is passed through unchanged -- so binary
producer->consumer chains must complete within one run.
"""
from __future__ import annotations