> ## Documentation Index
> Fetch the complete documentation index at: https://polos.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cookbook

> Example recipes for common Polos use cases

Practical examples showing how to build with Polos. All examples are available on [GitHub](https://github.com/polos-dev/polos/tree/main/python-examples).

## Agents

* [Agent with Tools](/docs/guides/01-agent-with-tools) - Create an agent with tools
* [Structured Output](/docs/guides/02-structured-output) - Get typed responses using Pydantic
* [Agent Streaming](/docs/guides/03-agent-streaming) - Stream responses in real-time
* [Conversational Chat](/docs/guides/04-conversational-chat) - Build a chat agent with memory
* [Thinking Agent](/docs/guides/05-thinking-agent) - Chain-of-thought reasoning
* [Guardrails](/docs/guides/06-guardrails) - Validate and filter responses
* [Lifecycle Hooks](/docs/guides/07-lifecycle-hooks) - Hook into agent execution
* [Multi-Agent Review](/docs/guides/14-multi-agent-review) - Coordinate multiple agents
* [Order Processing](/docs/guides/17-order-processing) - Order processing agent with structured output and fraud review
* [Sandbox Tools](/docs/guides/18-sandbox-tools) - Code execution in an isolated Docker container
* [Exec Security](/docs/guides/19-exec-security) - Allowlist-based command approval
* [Web Search Agent](/docs/guides/20-web-search-agent) - Research agent with Tavily web search
* [Local Sandbox](/docs/guides/21-local-sandbox) - Sandbox tools running on the host machine
* [Approval Page](/docs/guides/22-approval-page) - Web UI for workflow approval with suspend/resume
* [Slack Channel](/docs/guides/23-slack-channel) - Slack notifications when agents suspend for approval
* [Session Sandbox](/docs/guides/24-session-sandbox) - Reuse a sandbox across multiple agent runs

## Workflows

* [Workflow Basics](/docs/guides/08-workflow-basics) - Durable workflows with retry
* [Suspend and Resume](/docs/guides/09-suspend-resume) - Human-in-the-loop approvals
* [State Persistence](/docs/guides/10-state-persistence) - Typed state across executions
* [Error Handling](/docs/guides/11-error-handling) - Retries, fallbacks, rollback
* [Shared Queues](/docs/guides/12-shared-queues) - Control concurrency
* [Parallel Workflows](/docs/guides/13-parallel-workflows) - Fan-out/fan-in patterns
* [Event-Triggered](/docs/guides/15-event-triggered) - Trigger workflows from events
* [Scheduled Workflows](/docs/guides/16-scheduled-workflows) - Run on a cron schedule