internal/website/docs/examples/index.md
Runnable examples are the fastest way to move from reading the guides to changing one thing. Start with the path that matches where you are in the services → agents → workflows lifecycle.
For the provider-free first-agent route, run examples/first-agent, then follow No-secret First Agent, Your First Agent, Debugging your agent, and the 0→hero Reference.
| Goal | Runnable example | Why it is useful |
|---|---|---|
| 0→1 service | examples/hello-world | Smallest RPC service with a client call and health checks. |
| Provider-free first agent | examples/first-agent | Smallest service-backed agent with a deterministic mock model; no provider key required. |
| First service-backed agent | examples/agent-demo | Multi-service project/task/team app with agent playground integration. |
| 0→hero lifecycle | examples/support | No-secret support-desk story: typed services, an agent, an event-driven flow, and a guardrail. |
| Planning and delegation | examples/agent-plan-delegate | Two agents collaborate through plan and delegate over normal Go Micro RPC. |
| Durable agent runs | examples/agent-durable | Checkpoint and resume a model-directed run without replaying completed tool side effects. |
| Durable workflows | examples/flow-durable | Ordered, checkpointed flow steps resume without duplicating completed side effects. |
| AI-callable services | examples/mcp | MCP examples that expose service endpoints as model tools. |
examples/support
to see the full lifecycle before generating your own service.examples/first-agent
first for the smallest provider-free agent transcript.examples/agent-demo
or examples/support
when you want a complete service-backed agent to inspect.examples/first-agent
nearby as the smallest mock-model reproduction before inspecting richer runs.examples/support
for the human-readable scenario, then make harness for the full CI contract.examples/agent-plan-delegate.examples/flow-durable
for deterministic checkpointed steps,
examples/agent-durable
for model-directed checkpointed runs, and
examples/support
for the full services → agents → workflows lifecycle.See the repository examples index for the complete runnable list, including deployment, auth, gRPC interop, MCP, agent, and flow examples.