From 15ec1792539e0c4e60f2fec3c7dfd71ae31473ac Mon Sep 17 00:00:00 2001 From: Jerome Romualdez Date: Wed, 3 Jun 2026 10:40:10 -0400 Subject: [PATCH] docs: clarify task name is optional in adk.acp.create_task task/create is get-or-create by name, so reusing an existing name returns that task with its prior history rather than creating a new one. Document on the hand-written ADK entry point that name is optional: omit it (or make it unique) for a fresh task each call. Avoids accidental duplicate/stale tasks, especially in multi-agent delegation. Co-authored-by: Cursor --- src/agentex/lib/adk/_modules/acp.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/agentex/lib/adk/_modules/acp.py b/src/agentex/lib/adk/_modules/acp.py index 0c8cff05a..8a8e89236 100644 --- a/src/agentex/lib/adk/_modules/acp.py +++ b/src/agentex/lib/adk/_modules/acp.py @@ -68,7 +68,11 @@ async def create_task( Create a new task. Args: - name: The name of the task. + name: Optional human-readable name for the task. task/create is + get-or-create by name: omit it (or make it unique, e.g. append a + UUID) for a fresh task on each call; passing a name that already + exists returns that task with its prior history instead of + creating a new one. Keep it globally unique when set. agent_id: The ID of the agent to create the task for. agent_name: The name of the agent to create the task for. params: The parameters for the task.