wehub-resource-sync
e071084ebe
govulncheck / govulncheck (push) Waiting to run
Harness (E2E) / Harnesses (mock LLM) (push) Waiting to run
Harness (E2E) / Provider harnesses (live LLM conformance) (push) Waiting to run
Lint / golangci-lint (push) Waiting to run
Run Tests / Unit Tests (push) Waiting to run
Run Tests / Etcd Integration Tests (push) Waiting to run
63 lines
4.4 KiB
Markdown
63 lines
4.4 KiB
Markdown
---
|
|
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`](https://github.com/micro/go-micro/tree/master/examples/first-agent), then follow [No-secret First Agent](../guides/no-secret-first-agent.html), [Your First Agent](../guides/your-first-agent.html), [Debugging your agent](../guides/debugging-agents.html), and the [0→hero Reference](../guides/zero-to-hero.html).
|
|
|
|
| Goal | Runnable example | Why it is useful |
|
|
| --- | --- | --- |
|
|
| 0→1 service | [`examples/hello-world`](https://github.com/micro/go-micro/tree/master/examples/hello-world) | Smallest RPC service with a client call and health checks. |
|
|
| Provider-free first agent | [`examples/first-agent`](https://github.com/micro/go-micro/tree/master/examples/first-agent) | Smallest service-backed agent with a deterministic mock model; no provider key required. |
|
|
| First service-backed agent | [`examples/agent-demo`](https://github.com/micro/go-micro/tree/master/examples/agent-demo) | Multi-service project/task/team app with agent playground integration. |
|
|
| 0→hero lifecycle | [`examples/support`](https://github.com/micro/go-micro/tree/master/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`](https://github.com/micro/go-micro/tree/master/examples/agent-plan-delegate) | Two agents collaborate through `plan` and `delegate` over normal Go Micro RPC. |
|
|
| Durable agent runs | [`examples/agent-durable`](https://github.com/micro/go-micro/tree/master/examples/agent-durable) | Checkpoint and resume a model-directed run without replaying completed tool side effects. |
|
|
| Durable workflows | [`examples/flow-durable`](https://github.com/micro/go-micro/tree/master/examples/flow-durable) | Ordered, checkpointed flow steps resume without duplicating completed side effects. |
|
|
| AI-callable services | [`examples/mcp`](https://github.com/micro/go-micro/tree/master/examples/mcp) | MCP examples that expose service endpoints as model tools. |
|
|
|
|
## Guide-to-example map
|
|
|
|
- [Getting Started](../getting-started.html) → run
|
|
[`examples/support`](https://github.com/micro/go-micro/tree/master/examples/support)
|
|
to see the full lifecycle before generating your own service.
|
|
- [No-secret First Agent](../guides/no-secret-first-agent.html) → run
|
|
[`examples/first-agent`](https://github.com/micro/go-micro/tree/master/examples/first-agent)
|
|
first for the smallest provider-free agent transcript.
|
|
- [Your First Agent](../guides/your-first-agent.html) → run
|
|
[`examples/agent-demo`](https://github.com/micro/go-micro/tree/master/examples/agent-demo)
|
|
or [`examples/support`](https://github.com/micro/go-micro/tree/master/examples/support)
|
|
when you want a complete service-backed agent to inspect.
|
|
- [Debugging your agent](../guides/debugging-agents.html) → keep
|
|
[`examples/first-agent`](https://github.com/micro/go-micro/tree/master/examples/first-agent)
|
|
nearby as the smallest mock-model reproduction before inspecting richer runs.
|
|
- [0→hero Reference](../guides/zero-to-hero.html) → run
|
|
[`examples/support`](https://github.com/micro/go-micro/tree/master/examples/support)
|
|
for the human-readable scenario, then `make harness` for the full CI contract.
|
|
- [Plan & Delegate](../guides/plan-delegate.html) → run
|
|
[`examples/agent-plan-delegate`](https://github.com/micro/go-micro/tree/master/examples/agent-plan-delegate).
|
|
- [Agents and Workflows](../guides/agents-and-workflows.html) → run
|
|
[`examples/flow-durable`](https://github.com/micro/go-micro/tree/master/examples/flow-durable)
|
|
for deterministic checkpointed steps,
|
|
[`examples/agent-durable`](https://github.com/micro/go-micro/tree/master/examples/agent-durable)
|
|
for model-directed checkpointed runs, and
|
|
[`examples/support`](https://github.com/micro/go-micro/tree/master/examples/support)
|
|
for the full services → agents → workflows lifecycle.
|
|
|
|
## Repository examples
|
|
|
|
See the repository [examples index](https://github.com/micro/go-micro/tree/master/examples)
|
|
for the complete runnable list, including deployment, auth, gRPC interop, MCP,
|
|
agent, and flow examples.
|
|
|
|
## More
|
|
|
|
- [Real-World Examples](realworld/index.md)
|