Skip to content

Commit 0870f6f

Browse files
committed
Adding changes to convert agentic to async
1 parent fd495a9 commit 0870f6f

File tree

30 files changed

+73
-66
lines changed

30 files changed

+73
-66
lines changed

examples/tutorials/00_sync/000_hello_acp/manifest.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ agent:
6161

6262
# Type of ACP to use
6363
# sync: Simple synchronous ACP implementation
64-
# agentic: Advanced ACP with sub-types "base" or "temporal" (requires config)
64+
# async: Asynchronous, non-blocking ACP implementation
6565
acp_type: sync
6666

6767
# Description of what your agent does

examples/tutorials/10_async/00_base/000_hello_acp/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,6 @@ Three handlers instead of one, giving you full control over task lifecycle. Task
4444
- Building towards production systems
4545

4646
## Why This Matters
47-
The task-based model is the foundation of production agents. Unlike sync agents where each message is independent, agentic agents maintain persistent tasks that can receive multiple events, store state, and have full lifecycle management. This is the stepping stone to Temporal-based agents.
47+
The task-based model is the foundation of production agents. Unlike sync agents where each message is independent, async agents maintain persistent tasks that can receive multiple events, store state, and have full lifecycle management. This is the stepping stone to Temporal-based agents.
4848

4949
**Next:** [010_multiturn](../010_multiturn/) - Add conversation memory

examples/tutorials/10_async/00_base/000_hello_acp/manifest.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ deployment:
106106
global:
107107
agent:
108108
name: "ab000-hello-acp"
109-
description: "An AgentEx agent that is not intelligent. It just shows how to implement the base agentic ACP type."
109+
description: "An AgentEx agent that is not intelligent. It just shows how to implement the base async ACP type."
110110

111111
# Default replica count
112112
replicaCount: 1

examples/tutorials/10_async/00_base/010_multiturn/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,27 @@
1-
# [Agentic] Multiturn
1+
# [Async] Multiturn
22

3-
Handle multi-turn conversations in agentic agents with task-based state management. Each task maintains its own conversation history automatically.
3+
Handle multi-turn conversations in async agents with task-based state management. Each task maintains its own conversation history automatically.
44

55
## What You'll Learn
66
- How tasks maintain conversation state across multiple exchanges
7-
- Difference between sync and agentic multiturn patterns
7+
- Difference between sync and async multiturn patterns
88
- Building stateful conversational agents with minimal code
99

1010
## Prerequisites
1111
- Development environment set up (see [main repo README](https://github.com/scaleapi/scale-agentex))
1212
- Backend services running: `make dev` from repository root
13-
- Understanding of basic agentic agents (see [000_hello_acp](../000_hello_acp/))
13+
- Understanding of basic async agents (see [000_hello_acp](../000_hello_acp/))
1414

1515
## Quick Start
1616

1717
```bash
18-
cd examples/tutorials/10_agentic/00_base/010_multiturn
18+
cd examples/tutorials/10_async/00_base/010_multiturn
1919
uv run agentex agents run --manifest manifest.yaml
2020
```
2121

2222
## Key Pattern
2323

24-
Unlike sync agents where you manually track conversation history, agentic agents automatically maintain state within each task:
24+
Unlike sync agents where you manually track conversation history, async agents automatically maintain state within each task:
2525

2626
```python
2727
@app.on_task_event_send()

examples/tutorials/10_async/00_base/010_multiturn/dev.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929
"metadata": {},
3030
"outputs": [],
3131
"source": [
32-
"# (REQUIRED) Create a new task. For Agentic agents, you must create a task for messages to be associated with.\n",
32+
"# (REQUIRED) Create a new task. For Async agents, you must create a task for messages to be associated with.\n",
3333
"import uuid\n",
3434
"\n",
3535
"rpc_response = client.agents.create_task(\n",

examples/tutorials/10_async/00_base/020_streaming/README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
# [Agentic] Streaming
22

3-
Stream responses in agentic agents using `adk.messages.create()` to send progressive updates. More flexible than sync streaming since you can send multiple messages at any time.
3+
Stream responses in async agents using `adk.messages.create()` to send progressive updates. More flexible than sync streaming since you can send multiple messages at any time.
44

55
## What You'll Learn
66
- How to stream with explicit message creation
7-
- Difference between sync and agentic streaming patterns
7+
- Difference between sync and async streaming patterns
88
- When to send multiple messages vs single streamed response
99

1010
## Prerequisites
1111
- Development environment set up (see [main repo README](https://github.com/scaleapi/scale-agentex))
1212
- Backend services running: `make dev` from repository root
13-
- Understanding of agentic basics (see [000_hello_acp](../000_hello_acp/))
13+
- Understanding of async basics (see [000_hello_acp](../000_hello_acp/))
1414

1515
## Quick Start
1616

1717
```bash
18-
cd examples/tutorials/10_agentic/00_base/020_streaming
18+
cd examples/tutorials/10_async/00_base/020_streaming
1919
uv run agentex agents run --manifest manifest.yaml
2020
```
2121

@@ -33,7 +33,7 @@ async def handle_event_send(params: SendEventParams):
3333
await adk.messages.create(task_id=task_id, content=...)
3434
```
3535

36-
Unlike sync streaming (which uses async generators), agentic streaming uses explicit message creation calls, giving you more control over when and what to send.
36+
Unlike sync streaming (which uses async generators), async streaming uses explicit message creation calls, giving you more control over when and what to send.
3737

3838
## When to Use
3939
- Multi-step processes with intermediate results

examples/tutorials/10_async/00_base/030_tracing/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,12 @@ Add observability to your agents with spans and traces using `adk.tracing.start_
1111
## Prerequisites
1212
- Development environment set up (see [main repo README](https://github.com/scaleapi/scale-agentex))
1313
- Backend services running: `make dev` from repository root
14-
- Understanding of agentic agents (see [000_hello_acp](../000_hello_acp/))
14+
- Understanding of async agents (see [000_hello_acp](../000_hello_acp/))
1515

1616
## Quick Start
1717

1818
```bash
19-
cd examples/tutorials/10_agentic/00_base/030_tracing
19+
cd examples/tutorials/10_async/00_base/030_tracing
2020
uv run agentex agents run --manifest manifest.yaml
2121
```
2222

examples/tutorials/10_async/00_base/040_other_sdks/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,12 @@ Agents are just Python code - integrate any SDK you want (OpenAI, Anthropic, Lan
1111
## Prerequisites
1212
- Development environment set up (see [main repo README](https://github.com/scaleapi/scale-agentex))
1313
- Backend services running: `make dev` from repository root
14-
- Understanding of agentic agents (see [000_hello_acp](../000_hello_acp/))
14+
- Understanding of async agents (see [000_hello_acp](../000_hello_acp/))
1515

1616
## Quick Start
1717

1818
```bash
19-
cd examples/tutorials/10_agentic/00_base/040_other_sdks
19+
cd examples/tutorials/10_async/00_base/040_other_sdks
2020
uv run agentex agents run --manifest manifest.yaml
2121
```
2222

examples/tutorials/10_async/00_base/080_batch_events/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
# [Agentic] Batch Events
22

3-
Demonstrates limitations of the base agentic protocol with concurrent event processing. When multiple events arrive rapidly, base agentic agents handle them sequentially, which can cause issues.
3+
Demonstrates limitations of the base async protocol with concurrent event processing. When multiple events arrive rapidly, base async agents handle them sequentially, which can cause issues.
44

55
## What You'll Learn
6-
- Limitations of non-Temporal agentic agents
6+
- Limitations of non-Temporal async agents
77
- Race conditions and ordering issues in concurrent scenarios
88
- When you need workflow orchestration
99
- Why this motivates Temporal adoption
1010

1111
## Prerequisites
1212
- Development environment set up (see [main repo README](https://github.com/scaleapi/scale-agentex))
1313
- Backend services running: `make dev` from repository root
14-
- Understanding of agentic patterns (see previous tutorials)
14+
- Understanding of async patterns (see previous tutorials)
1515

1616
## Quick Start
1717

1818
```bash
19-
cd examples/tutorials/10_agentic/00_base/080_batch_events
19+
cd examples/tutorials/10_async/00_base/080_batch_events
2020
uv run agentex agents run --manifest manifest.yaml
2121
```
2222

@@ -27,15 +27,15 @@ This tutorial shows **when you need Temporal**. If your agent needs to:
2727
- Process multiple events in parallel safely
2828
- Maintain consistent state under concurrent load
2929

30-
Then you should use Temporal workflows (see tutorials 10_agentic/10_temporal/) which provide:
30+
Then you should use Temporal workflows (see tutorials 10_async/10_temporal/) which provide:
3131
- Deterministic event ordering
3232
- Safe concurrent processing
3333
- Guaranteed state consistency
3434

3535
This is the "breaking point" tutorial that motivates moving to Temporal for production agents.
3636

3737
## When to Use (This Pattern)
38-
This tutorial shows what NOT to use for production. Use base agentic agents only when:
38+
This tutorial shows what NOT to use for production. Use base async agents only when:
3939
- Events are infrequent (< 1 per second)
4040
- Order doesn't matter
4141
- State consistency isn't critical

examples/tutorials/10_async/00_base/090_multi_agent_non_temporal/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,13 @@ The system uses a shared build configuration with type-safe interfaces:
4949
- Backend services running: `make dev` from repository root
5050
- Python 3.12+ and uv package manager
5151
- OpenAI API key (set `OPENAI_API_KEY` or create `.env` file)
52-
- Understanding of agentic patterns (see previous tutorials)
52+
- Understanding of async patterns (see previous tutorials)
5353

5454
### Running the System
5555

5656
1. **Start all agents**:
5757
```bash
58-
cd examples/tutorials/10_agentic/00_base/090_multi_agent_non_temporal
58+
cd examples/tutorials/10_async/00_base/090_multi_agent_non_temporal
5959
./start-agents.sh start
6060
```
6161

0 commit comments

Comments
 (0)