chore(ag-ui): improve example instructions and docs

Improve the agent instructions for more reliable execution and update
the documentation with more examples and formatting fixes.

Author: stevenh

examples/pydantic_ai_ag_ui_examples/README.md

@@ -58,6 +58,16 @@ What is the time in New York?
 Change the background to blue
 ```
 
+A complex example which mixes both AG-UI and PydanticAI tools:
+
+```text
+Perform the following steps, waiting for the response of each step before continuing:
+1. Get the time
+2. Set the background to red
+3. Get the time
+4. Report how long the background set took by diffing the two times
+```
+
 ### [Agentic Generative UI](http://localhost:3000/pydantic-ai/feature/agentic_generative_ui)
 
 Demonstrates a long running task where the agent sends updates to the frontend
@@ -108,8 +118,7 @@ Bruce was a good dog,
 Agent prompt
 
 ```text
-Help me complete my story about bruce the dog, is should be no longer than a
-sentence.
+Help me complete my story about bruce the dog, is should be no longer than a sentence.
 ```
 
 ### [Shared State](http://localhost:3000/pydantic-ai/feature/shared_state)

examples/pydantic_ai_ag_ui_examples/api/human_in_the_loop.py

@@ -20,10 +20,10 @@
 
 instructions: str = """When planning tasks use tools only, without any other messages.
 IMPORTANT:
-- Use the `human_in_the_loop` tool to display the suggested steps to the user
+- Use the `generate_task_steps` tool to display the suggested steps to the user
 - Never repeat the plan, or send a message detailing steps
 - If accepted, confirm the creation of the plan and the number of selected (enabled) steps only
-- If rejected, ask the user for additional information
+- If not accepted, ask the user for more information, DO NOT use the `generate_task_steps` tool again
 """
 router: APIRouter = APIRouter(prefix='/human_in_the_loop')
 agui: AGUIAgent = AGUIAgent(instructions=instructions)