Skip to content

Commit 63eaf79

Browse files
authored
WIP - fixing typos (#20203)
* add what are agents * update other files
1 parent 36db5d8 commit 63eaf79

File tree

9 files changed

+22130
-12
lines changed

9 files changed

+22130
-12
lines changed

src/assets/images/agents/agent-workflow.svg

Lines changed: 7362 additions & 0 deletions
Loading

src/assets/images/agents/co-pilot.svg

Lines changed: 7356 additions & 0 deletions
Loading
13 KB
Loading

src/assets/images/agents/workflow-automation.svg

Lines changed: 7348 additions & 0 deletions
Loading

src/content/docs/agents/concepts/calling-llms.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: Communicating with users
2+
title: Calling LLMs
33
pcx_content_type: concept
44
sidebar:
5-
order: 4
5+
order: 5
66

77
---
88

src/content/docs/agents/concepts/communcating-with-users.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: Calling LLMs
2+
title: Human in the Loop
33
pcx_content_type: concept
44
sidebar:
5-
order: 3
5+
order: 4
66

77
---
88

Lines changed: 57 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,66 @@
11
---
2-
title: Workflows
2+
title: What are Agents?
33
pcx_content_type: concept
44
sidebar:
5-
order: 1
5+
order: 2
66

77
---
88

99
import { Render } from "~/components";
1010

11-
TODO - what are agents?
11+
### What is an agent?
12+
An agent is an AI system that can autonomously execute tasks by making decisions about tool usage and process flow. Unlike traditional automation that follows predefined paths, agents can dynamically adapt their approach based on context and intermediate results. Agents are also distinct from co-pilots (e.g. traditional chat applications) in that they can fully automate a task, as opposed to simply augmenting and extending human input.
1213

13-
- terminology
14-
- diagram: orchestrator / container / task / workflow
14+
- **Agents** → non-linear, non-deterministic (can change from run to run)
15+
- **Workflows** → linear, deterministic execution paths
16+
- **Co-pilots** → augmentative AI assistance requiring human intervention
17+
18+
### Example: Booking Vacations
19+
If this is your first time working with, or interacting with agents, this example will illustrate how an agent works within a context like booking a vacation. If you're already familiar with the topic, read on.
20+
21+
Imagine you're trying to book a vacation. You need to research flights, find hotels, check restaurant reviews, and keep track of your budget.
22+
23+
##### Traditional Workflow Automation
24+
A traditional automation system follows a predetermined sequence:
25+
- Takes specific inputs (dates, location, budget)
26+
- Calls predefined API endpoints in a fixed order
27+
- Returns results based on hardcoded criteria
28+
- Cannot adapt if unexpected situations arise
29+
30+
![Traditional workflow automation diagram](~/assets/images/agents/workflow-automation.svg)
31+
32+
##### AI Co-pilot
33+
A co-pilot acts as an intelligent assistant that:
34+
35+
- Provides hotel and itinerary recommendations based on your preferences
36+
- Can understand and respond to natural language queries
37+
- Offers guidance and suggestions
38+
- Requires human decision-making and action for execution
39+
40+
![A co-pilot diagram](~/assets/images/agents/co-pilot.svg)
41+
42+
##### Agent
43+
An agent combines AI's ability to make judgements and call the relevant tools to execute the task. An agent's output will be nondeterministic given:
44+
45+
- Real-time availability and pricing changes
46+
- Dynamic prioritization of constraints
47+
- Ability to recover from failures
48+
- Adaptive decision-making based on intermediate results
49+
50+
![An agent diagram](~/assets/images/agents/agent-workflow.svg)
51+
52+
An agents can dynamically generate and itinerary and execute on booking reservations, similarly to what you would expect from a travel agent.
53+
54+
### Three primary components of agent systems:
55+
56+
- **Decision Engine**: Usually an LLM (Large Language Model) that determines action steps
57+
- **Tool Integration**: APIs, functions, and services the agent can utilize
58+
- **Memory System**: Maintains context and tracks task progress
59+
60+
#### How Agents Work
61+
62+
Agents operate in a continuous loop of:
63+
1. **Observing** the current state or task
64+
2. **Planning** what actions to take, using AI for reasoning
65+
3. **Executing** those actions using available tools (often APIs or [MCPs](https://modelcontextprotocol.io/introduction))
66+
4. **Learning** from the results (storing results in memory, updating task progress, and preparing for next iteration)

src/content/docs/agents/concepts/workflows.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: What are Agents
2+
title: Workflows
33
pcx_content_type: concept
44
sidebar:
5-
order: 2
5+
order: 3
66

77
---
88

src/content/docs/agents/getting-started/quick-start.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ If you're new to Cloudflare Workers, Agents, or Cloudflare in general, we recomm
1717

1818
:::
1919

20-
TODO: quick start. <= 5 steps.
20+
TODO: quick start
2121

2222
1. Use the template to create a new project
2323
2. Open `src/index.ts`

0 commit comments

Comments
 (0)