micro--go-micro/internal/website/docs/examples/index.md

layout

layout
default

Learn by Example

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.

Start here

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.

Guide-to-example map

• Getting Started → run examples/support to see the full lifecycle before generating your own service.
• No-secret First Agent → run examples/first-agent first for the smallest provider-free agent transcript.
• Your First Agent → run examples/agent-demo or examples/support when you want a complete service-backed agent to inspect.
• Debugging your agent → keep examples/first-agent nearby as the smallest mock-model reproduction before inspecting richer runs.
• 0→hero Reference → run examples/support for the human-readable scenario, then make harness for the full CI contract.
• Plan & Delegate → run examples/agent-plan-delegate.
• Agents and Workflows → run 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.

Repository examples

See the repository examples index for the complete runnable list, including deployment, auth, gRPC interop, MCP, agent, and flow examples.

More

• Real-World Examples