micro--go-micro
Asim Aslam
c7657f73f4
goreleaser / goreleaser (push) Has been cancelled
* test(harness): read agent plan from the scoped store
The store-scoping change moved an agent's plan from the default table
key agent/{name}/plan to its own table (database "agent", table {name},
key "plan"). The plan-delegate harness tests still read the old key and
failed with 'not found'; read through store.Scope(mem, "agent", name)
like the agent does.
* docs: orient agents-first across README, landing, and docs overview
Lead with agents (then services and flows), surface MCP + A2A as the
interop story, and frame agents as services. Landing hero and feature
grid reordered agents-first with an A2A gateway card.
* v6: module path go-micro.dev/v6, TLS secure by default, NewService
Cut v6. Three breaking changes, bundled so the major bump is paid once:
- Module path go-micro.dev/v5 -> go-micro.dev/v6 across all imports + go.mod.
- TLS verification on by default (was off). MICRO_TLS_SECURE removed;
MICRO_TLS_INSECURE=true opts out for self-signed/dev.
- micro.NewService(name, opts...) is the canonical service constructor,
symmetric with NewAgent/NewFlow; micro.New kept as a deprecated alias;
the old name-less NewService(opts...) removed. Generators emit NewService.
Also ports the JWT auth token provider in-module (go-micro.dev/v6/auth/jwt/token
on golang-jwt/jwt/v5), dropping the v5-pinned github.com/micro/plugins/v5/auth/jwt
and the deprecated dgrijalva/jwt-go.
Docs/README/landing updated to v6 and @latest; v5->v6 migration guide added;
CHANGELOG cut as [6.0.0]. Blog posts left at their historical versions.
---------
Co-authored-by: Claude <noreply@anthropic.com>
61 行
2.6 KiB
Markdown
61 行
2.6 KiB
Markdown
---
|
|
layout: default
|
|
---
|
|
|
|
# Docs
|
|
|
|
Documentation for the Go Micro framework.
|
|
|
|
## Overview
|
|
|
|
<img src="/images/generated/architecture.jpg" alt="Go Micro architecture" style="width: 100%; border-radius: 8px; margin-bottom: 1.5rem;" />
|
|
|
|
Go Micro is a framework for building agents and services in Go. Build an agent and it gets a model, memory, and tools, manages your services, and is reachable over [MCP](https://modelcontextprotocol.io/) and [A2A](https://a2a-protocol.org). Write services and they register, discover each other, and every endpoint is automatically an AI-callable tool. Orchestrate the deterministic parts with 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
|
|
|
|
To get started follow the getting started guide.
|
|
Otherwise continue to read the docs for more information
|
|
about the framework.
|
|
|
|
## Contents
|
|
|
|
- [Getting Started](getting-started.html)
|
|
- [MCP & AI Agents](mcp.html) - Turn services into AI-callable tools with the Model Context Protocol
|
|
- [CLI & Gateway Guide](guides/cli-gateway.html) - Development vs Production modes
|
|
- [Quick Start](quickstart.html)
|
|
- [Architecture](architecture.html)
|
|
- [Configuration](config.html)
|
|
- [Registry](registry.html)
|
|
- [Broker](broker.html)
|
|
- [Client/Server](client-server.html)
|
|
- [Transport](transport.html)
|
|
- [Store](store.html)
|
|
- [Plugins](plugins.html)
|
|
- [Examples](examples/index.md)
|
|
|
|
## Development & Deployment
|
|
|
|
- [micro run](guides/micro-run.html) - Local development with hot reload, API gateway, and agent playground
|
|
- [micro build & deploy](deployment.html) - Build binaries and deploy to production
|
|
- [micro server](server.html) - Optional production web dashboard with auth
|
|
|
|
## AI & Agents
|
|
|
|
- [Building AI-Native Services](guides/ai-native-services.html) - End-to-end tutorial for MCP-enabled services
|
|
- [MCP Security Guide](guides/mcp-security.html) - Auth, scopes, rate limiting, and audit logging
|
|
- [Tool Description Best Practices](guides/tool-descriptions.html) - Writing docs that make agents effective
|
|
- [Agent Integration Patterns](guides/agent-patterns.html) - Multi-agent workflows and architectures
|
|
|
|
## Advanced
|
|
|
|
- [Framework Comparison](guides/comparison.html)
|
|
- [Architecture Decisions](architecture/index.md)
|
|
- [Real-World Examples](examples/realworld/index.md)
|
|
- [Migration Guides](guides/migration/index.md)
|
|
- [Observability](observability.html)
|
|
- [Contributing](contributing.html)
|
|
- [Roadmap](roadmap.html)
|