micro--go-micro
Asim Aslam
35bc58e5d2
* blog: 'Not Everything Should Be an Agent' (#18) on workflows The workflow counterpart to the plan/delegate post: when the path is known, use a deterministic Flow, not an autonomous agent. Frames flow vs agent as two modes of the same building blocks, covers flow-triggers- agent dispatch and the agent guardrails, and gives the simplest-first guidance (single call -> workflow -> agent). Continues the arc from blog 14/16/17; references Building Effective Agents in passing. * docs: fix new-user onboarding friction - README: lead Quick Start with a no-key 30-second path (micro new -> micro run -> curl), then the AI --prompt path with an explicit 'export ANTHROPIC_API_KEY' so the headline command no longer fails silently for users without a key. - Unify all install versions to v5.26.0 (README + docs were split across v5.16.0 / v5.25.0). - Refresh the docs landing overview from the old 'microservices framework' framing to 'services and agents', matching the README. - getting-started: add Prerequisites (Go 1.21+, and that a provider key is only needed for AI features). - README features: Flows -> Workflows wording. --------- Co-authored-by: Claude <noreply@anthropic.com>
2.5 KiB
2.5 KiB
layout
| layout |
|---|
| default |
Docs
Documentation for the Go Micro framework.
Overview
Go Micro is a framework for building services and agents in Go. Write services — they register, discover each other, and communicate via RPC and events. Every endpoint is automatically an AI-callable tool via MCP, so AI agents can use your services the moment they run. Build agents to orchestrate them, and workflows to trigger them on events — all from the same primitives.
It's built on a pluggable architecture of Go interfaces: service discovery, client/server RPC, pub/sub, plus auth, caching, and storage. Sane defaults out of the box, everything swappable.
Learn More
To get started follow the getting started guide. Otherwise continue to read the docs for more information about the framework.
Contents
- Getting Started
- MCP & AI Agents - Turn services into AI-callable tools with the Model Context Protocol
- CLI & Gateway Guide - Development vs Production modes
- Quick Start
- Architecture
- Configuration
- Registry
- Broker
- Client/Server
- Transport
- Store
- Plugins
- Examples
Development & Deployment
- micro run - Local development with hot reload, API gateway, and agent playground
- micro build & deploy - Build binaries and deploy to production
- micro server - Optional production web dashboard with auth
AI & Agents
- Building AI-Native Services - End-to-end tutorial for MCP-enabled services
- MCP Security Guide - Auth, scopes, rate limiting, and audit logging
- Tool Description Best Practices - Writing docs that make agents effective
- Agent Integration Patterns - Multi-agent workflows and architectures