5.7 KiB
layout
| layout |
|---|
| default |
Docs
Documentation for the Go Micro agent harness and service framework.
Overview
Go Micro is an agent harness and service framework for Go. A harness is the runtime around an agent: tools, memory, guardrails, workflows, state, discovery, and interop. Build an agent and it gets a model, memory, tools, planning, delegation, and service discovery; it is reachable over MCP and A2A. Write services and every endpoint becomes an AI-callable tool. Orchestrate the deterministic parts with durable flows. Agents, services, and flows come from the same primitives because an agent is a distributed system, and building one is building a service.
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
Start with Getting Started for install and the first local service. Then follow the first-agent on-ramp in the same order as the README: micro agent demo for the installed no-secret CLI affordance, micro agent quickcheck (or micro agent debug) for the short recovery map, micro examples for the provider-free examples map, micro zero-to-hero for the maintained lifecycle harness, examples wayfinding index for the runnable examples map, the smallest first-agent example for the fastest provider-free run, the 0→hero support reference for the full no-secret lifecycle example, No-secret first-agent transcript to run a mock-model support agent, Your First Agent to build a service-backed agent and talk to it with micro chat, Debugging your agent to use micro inspect agent <name> for runs and memory, and the 0→hero reference path to walk the full scaffold → run → chat → inspect → deploy dry-run lifecycle covered by CI.
Otherwise continue to read the docs for more information about the framework.
Contents
- Getting Started
- 0→hero Reference - Walk scaffold → run → chat →
micro inspect agent <name>→ deploy dry-run with CI-backed commands micro agent demo- Show the provider-free first-agent demo command and next docs stepsmicro agent quickcheck(alias:micro agent debug) - Show the stalled first-agent recovery map before the full debugging guidemicro examples- Show provider-free first-agent examples in copy/paste order- Examples wayfinding index - Choose the first-agent, support, and interop examples from one map
- Smallest first-agent example - Run one service-backed agent with a deterministic mock model
- 0→hero support reference - Run the maintained no-secret services → agents → workflows example
- No-secret first-agent transcript - Run the first useful agent path without a provider key
- Your First Agent - Build a service-backed agent and talk to it with
micro chat - MCP & AI Agents - Turn services into AI-callable tools with the Model Context Protocol
- CLI & Gateway Guide - Development vs Production modes
micro loopquickstart - Scaffold an autonomous CI-gated improvement loop- 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
- 0→hero Reference - Walk scaffold → run → chat →
micro inspect agent <name>→ deploy dry-run with CI-backed commands - No-secret first-agent transcript - Run the first useful agent path without a provider key
- Your First Agent - Build a service-backed agent and talk to it with
micro chat - 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 harness patterns and architectures