micro--go-micro
1bc886fa82
* docs: Agent interface design sketch Proposes Agent as a top-level abstraction alongside Service in the micro package. Agent manages services — scoped tools, system prompt, conversation memory, registry-discoverable. Design only, no implementation. https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: Agent as a first-class abstraction Introduce micro.NewAgent() alongside micro.New() — Agent is to intelligence what Service is to capability. Agent interface: - Chat(ctx, message) (*Response, error) — core interaction method - Run() — registers in registry, subscribes to broker, blocks - Stop() — graceful shutdown - Scoped tools — only sees endpoints of its assigned services - Persistent memory — conversation history stored in store - Agent-to-agent — communication via broker topics Top-level API: agent := micro.NewAgent("task-mgr", micro.AgentServices("task"), micro.AgentPrompt("You manage tasks."), micro.AgentProvider("anthropic"), ) agent.Run() https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: wire agents into chat router, add micro agent CLI, expose Flow Three top-level abstractions: micro.New("task") — Service (capability) micro.NewAgent("task-mgr") — Agent (intelligence) micro.NewFlow("onboard-user") — Flow (event-driven orchestration) micro chat as router: - Discovers agents from registry on startup - Single agent: routes directly - Multiple agents: LLM classifies intent, dispatches to right agent via route_to_agent tool - No agents: falls back to current direct-service behaviour - Banner shows discovered agents micro agent CLI: - micro agent list — shows registered agents and their services - micro agent describe <name> — shows agent details from registry https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: move flow to top level, update docs for three abstractions Package structure now consistent: service/ — Service (capability) agent/ — Agent (intelligence) flow/ — Flow (event-driven orchestration) ai/flow/ kept as backward-compatible re-export. Updated across all surfaces: - CLAUDE.md: added agent/ and flow/ to project structure - README: added "Building Agents" section with NewAgent() examples, updated features table (Agents, Flows, Chat router), CLI table (agent list, agent describe), docs links - Website: features grid shows Services, Agents, Flows as the three pillars alongside generation, MCP, and pluggable architecture - micro.go: Flow imported from top-level flow/ package https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * docs: rewrite getting-started, fix ai-integration import paths Getting started now covers all three abstractions: - Service (write handlers, micro run, templates) - Agent (micro.NewAgent, scoped tools, memory, CLI) - Flow (event-driven LLM orchestration) Leads with prompt-based generation, then manual service creation. ai-integration.md: fixed flow import path from go-micro.dev/v5/ai/flow to go-micro.dev/v5/flow, updated stack diagram to show agent/flow/chat. https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * blog: Introducing micro.NewAgent() Post 16 — announces Agent as a first-class abstraction. Shows the API (NewAgent, AgentServices, AgentPrompt, AgentProvider), scoped tools, persistent memory, multi-service agents, multi-agent systems, and the three-abstraction comparison table (Service/Agent/Flow). https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: fix agent registration, blog post 16 Agent registration: - Add node with address so mDNS can discover agents - Store type and services in node metadata (mDNS requirement) - Connect broker before subscribing, non-fatal if broker unavailable - Print registration confirmation on Run() Agent/chat discovery: - Check both service-level and node-level metadata for type=agent (mDNS stores metadata on nodes, not services) Blog post 16: "Introducing micro.NewAgent()" — announces the Agent abstraction with code examples, comparison table, multi-agent patterns. Tested end-to-end: micro run → micro agent list discovers the agent → micro chat routes to it → agent calls service endpoints. https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: agents are proper services with RPC Chat endpoint Refactored agent to use server.Server instead of fake registry entries. An agent now: - Creates a real RPC server with server.Name(agentName) - Registers an Agent.Chat handler callable via standard RPC - Sets server metadata type=agent, services=x,y for discovery - No more fake addresses or broker hacks micro chat calls agents via RPC (client.Call) instead of creating local agent instances. The registry stays clean — agents are real services with real endpoints. Removed broker dependency from agent options. Agent-to-agent communication is just RPC like everything else. https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: agent uses proto-defined RPC interface Added agent/proto/agent.proto with Agent service definition: rpc Chat(ChatRequest) returns (ChatResponse) Agent now implements the generated AgentHandler interface and registers via pb.RegisterAgentHandler. The Chat endpoint is a standard proto-based RPC callable by any go-micro client. Renamed the programmatic API from Chat() to Ask() to avoid collision with the proto handler method name. micro chat calls agents via standard RPC with JSON-encoded request/response — no special types needed on the caller side. https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd * feat: generate agent alongside services, update all docs micro run --prompt now generates an agent binary that manages all the generated services. The agent reads MICRO_AI_PROVIDER and MICRO_AI_API_KEY from the environment. micro run propagates these when started with --prompt. Run banner shows services and agents separately. Updated README, getting-started guide, and landing page to show the complete flow: generate → services + agent start → micro chat routes to agent → agent orchestrates services. https://claude.ai/code/session_01QTp4SshuVmLAvvEGJe4TJd --------- Co-authored-by: Claude <noreply@anthropic.com>
268 行
7.4 KiB
Go
268 行
7.4 KiB
Go
// Code generated by protoc-gen-go. DO NOT EDIT.
|
|
// versions:
|
|
// protoc-gen-go v1.36.11
|
|
// protoc v3.21.12
|
|
// source: proto/agent.proto
|
|
|
|
package agent
|
|
|
|
import (
|
|
protoreflect "google.golang.org/protobuf/reflect/protoreflect"
|
|
protoimpl "google.golang.org/protobuf/runtime/protoimpl"
|
|
reflect "reflect"
|
|
sync "sync"
|
|
unsafe "unsafe"
|
|
)
|
|
|
|
const (
|
|
// Verify that this generated code is sufficiently up-to-date.
|
|
_ = protoimpl.EnforceVersion(20 - protoimpl.MinVersion)
|
|
// Verify that runtime/protoimpl is sufficiently up-to-date.
|
|
_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
|
|
)
|
|
|
|
type ChatRequest struct {
|
|
state protoimpl.MessageState `protogen:"open.v1"`
|
|
Message string `protobuf:"bytes,1,opt,name=message,proto3" json:"message,omitempty"`
|
|
unknownFields protoimpl.UnknownFields
|
|
sizeCache protoimpl.SizeCache
|
|
}
|
|
|
|
func (x *ChatRequest) Reset() {
|
|
*x = ChatRequest{}
|
|
mi := &file_proto_agent_proto_msgTypes[0]
|
|
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
|
|
ms.StoreMessageInfo(mi)
|
|
}
|
|
|
|
func (x *ChatRequest) String() string {
|
|
return protoimpl.X.MessageStringOf(x)
|
|
}
|
|
|
|
func (*ChatRequest) ProtoMessage() {}
|
|
|
|
func (x *ChatRequest) ProtoReflect() protoreflect.Message {
|
|
mi := &file_proto_agent_proto_msgTypes[0]
|
|
if x != nil {
|
|
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
|
|
if ms.LoadMessageInfo() == nil {
|
|
ms.StoreMessageInfo(mi)
|
|
}
|
|
return ms
|
|
}
|
|
return mi.MessageOf(x)
|
|
}
|
|
|
|
// Deprecated: Use ChatRequest.ProtoReflect.Descriptor instead.
|
|
func (*ChatRequest) Descriptor() ([]byte, []int) {
|
|
return file_proto_agent_proto_rawDescGZIP(), []int{0}
|
|
}
|
|
|
|
func (x *ChatRequest) GetMessage() string {
|
|
if x != nil {
|
|
return x.Message
|
|
}
|
|
return ""
|
|
}
|
|
|
|
type ChatResponse struct {
|
|
state protoimpl.MessageState `protogen:"open.v1"`
|
|
Reply string `protobuf:"bytes,1,opt,name=reply,proto3" json:"reply,omitempty"`
|
|
Agent string `protobuf:"bytes,2,opt,name=agent,proto3" json:"agent,omitempty"`
|
|
ToolCalls []*ToolCall `protobuf:"bytes,3,rep,name=tool_calls,json=toolCalls,proto3" json:"tool_calls,omitempty"`
|
|
unknownFields protoimpl.UnknownFields
|
|
sizeCache protoimpl.SizeCache
|
|
}
|
|
|
|
func (x *ChatResponse) Reset() {
|
|
*x = ChatResponse{}
|
|
mi := &file_proto_agent_proto_msgTypes[1]
|
|
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
|
|
ms.StoreMessageInfo(mi)
|
|
}
|
|
|
|
func (x *ChatResponse) String() string {
|
|
return protoimpl.X.MessageStringOf(x)
|
|
}
|
|
|
|
func (*ChatResponse) ProtoMessage() {}
|
|
|
|
func (x *ChatResponse) ProtoReflect() protoreflect.Message {
|
|
mi := &file_proto_agent_proto_msgTypes[1]
|
|
if x != nil {
|
|
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
|
|
if ms.LoadMessageInfo() == nil {
|
|
ms.StoreMessageInfo(mi)
|
|
}
|
|
return ms
|
|
}
|
|
return mi.MessageOf(x)
|
|
}
|
|
|
|
// Deprecated: Use ChatResponse.ProtoReflect.Descriptor instead.
|
|
func (*ChatResponse) Descriptor() ([]byte, []int) {
|
|
return file_proto_agent_proto_rawDescGZIP(), []int{1}
|
|
}
|
|
|
|
func (x *ChatResponse) GetReply() string {
|
|
if x != nil {
|
|
return x.Reply
|
|
}
|
|
return ""
|
|
}
|
|
|
|
func (x *ChatResponse) GetAgent() string {
|
|
if x != nil {
|
|
return x.Agent
|
|
}
|
|
return ""
|
|
}
|
|
|
|
func (x *ChatResponse) GetToolCalls() []*ToolCall {
|
|
if x != nil {
|
|
return x.ToolCalls
|
|
}
|
|
return nil
|
|
}
|
|
|
|
type ToolCall struct {
|
|
state protoimpl.MessageState `protogen:"open.v1"`
|
|
Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
|
|
Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
|
|
Input string `protobuf:"bytes,3,opt,name=input,proto3" json:"input,omitempty"`
|
|
Result string `protobuf:"bytes,4,opt,name=result,proto3" json:"result,omitempty"`
|
|
unknownFields protoimpl.UnknownFields
|
|
sizeCache protoimpl.SizeCache
|
|
}
|
|
|
|
func (x *ToolCall) Reset() {
|
|
*x = ToolCall{}
|
|
mi := &file_proto_agent_proto_msgTypes[2]
|
|
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
|
|
ms.StoreMessageInfo(mi)
|
|
}
|
|
|
|
func (x *ToolCall) String() string {
|
|
return protoimpl.X.MessageStringOf(x)
|
|
}
|
|
|
|
func (*ToolCall) ProtoMessage() {}
|
|
|
|
func (x *ToolCall) ProtoReflect() protoreflect.Message {
|
|
mi := &file_proto_agent_proto_msgTypes[2]
|
|
if x != nil {
|
|
ms := protoimpl.X.MessageStateOf(protoimpl.Pointer(x))
|
|
if ms.LoadMessageInfo() == nil {
|
|
ms.StoreMessageInfo(mi)
|
|
}
|
|
return ms
|
|
}
|
|
return mi.MessageOf(x)
|
|
}
|
|
|
|
// Deprecated: Use ToolCall.ProtoReflect.Descriptor instead.
|
|
func (*ToolCall) Descriptor() ([]byte, []int) {
|
|
return file_proto_agent_proto_rawDescGZIP(), []int{2}
|
|
}
|
|
|
|
func (x *ToolCall) GetId() string {
|
|
if x != nil {
|
|
return x.Id
|
|
}
|
|
return ""
|
|
}
|
|
|
|
func (x *ToolCall) GetName() string {
|
|
if x != nil {
|
|
return x.Name
|
|
}
|
|
return ""
|
|
}
|
|
|
|
func (x *ToolCall) GetInput() string {
|
|
if x != nil {
|
|
return x.Input
|
|
}
|
|
return ""
|
|
}
|
|
|
|
func (x *ToolCall) GetResult() string {
|
|
if x != nil {
|
|
return x.Result
|
|
}
|
|
return ""
|
|
}
|
|
|
|
var File_proto_agent_proto protoreflect.FileDescriptor
|
|
|
|
const file_proto_agent_proto_rawDesc = "" +
|
|
"\n" +
|
|
"\x11proto/agent.proto\x12\x05agent\"'\n" +
|
|
"\vChatRequest\x12\x18\n" +
|
|
"\amessage\x18\x01 \x01(\tR\amessage\"j\n" +
|
|
"\fChatResponse\x12\x14\n" +
|
|
"\x05reply\x18\x01 \x01(\tR\x05reply\x12\x14\n" +
|
|
"\x05agent\x18\x02 \x01(\tR\x05agent\x12.\n" +
|
|
"\n" +
|
|
"tool_calls\x18\x03 \x03(\v2\x0f.agent.ToolCallR\ttoolCalls\"\\\n" +
|
|
"\bToolCall\x12\x0e\n" +
|
|
"\x02id\x18\x01 \x01(\tR\x02id\x12\x12\n" +
|
|
"\x04name\x18\x02 \x01(\tR\x04name\x12\x14\n" +
|
|
"\x05input\x18\x03 \x01(\tR\x05input\x12\x16\n" +
|
|
"\x06result\x18\x04 \x01(\tR\x06result2:\n" +
|
|
"\x05Agent\x121\n" +
|
|
"\x04Chat\x12\x12.agent.ChatRequest\x1a\x13.agent.ChatResponse\"\x00B\x0fZ\r./proto;agentb\x06proto3"
|
|
|
|
var (
|
|
file_proto_agent_proto_rawDescOnce sync.Once
|
|
file_proto_agent_proto_rawDescData []byte
|
|
)
|
|
|
|
func file_proto_agent_proto_rawDescGZIP() []byte {
|
|
file_proto_agent_proto_rawDescOnce.Do(func() {
|
|
file_proto_agent_proto_rawDescData = protoimpl.X.CompressGZIP(unsafe.Slice(unsafe.StringData(file_proto_agent_proto_rawDesc), len(file_proto_agent_proto_rawDesc)))
|
|
})
|
|
return file_proto_agent_proto_rawDescData
|
|
}
|
|
|
|
var file_proto_agent_proto_msgTypes = make([]protoimpl.MessageInfo, 3)
|
|
var file_proto_agent_proto_goTypes = []any{
|
|
(*ChatRequest)(nil), // 0: agent.ChatRequest
|
|
(*ChatResponse)(nil), // 1: agent.ChatResponse
|
|
(*ToolCall)(nil), // 2: agent.ToolCall
|
|
}
|
|
var file_proto_agent_proto_depIdxs = []int32{
|
|
2, // 0: agent.ChatResponse.tool_calls:type_name -> agent.ToolCall
|
|
0, // 1: agent.Agent.Chat:input_type -> agent.ChatRequest
|
|
1, // 2: agent.Agent.Chat:output_type -> agent.ChatResponse
|
|
2, // [2:3] is the sub-list for method output_type
|
|
1, // [1:2] is the sub-list for method input_type
|
|
1, // [1:1] is the sub-list for extension type_name
|
|
1, // [1:1] is the sub-list for extension extendee
|
|
0, // [0:1] is the sub-list for field type_name
|
|
}
|
|
|
|
func init() { file_proto_agent_proto_init() }
|
|
func file_proto_agent_proto_init() {
|
|
if File_proto_agent_proto != nil {
|
|
return
|
|
}
|
|
type x struct{}
|
|
out := protoimpl.TypeBuilder{
|
|
File: protoimpl.DescBuilder{
|
|
GoPackagePath: reflect.TypeOf(x{}).PkgPath(),
|
|
RawDescriptor: unsafe.Slice(unsafe.StringData(file_proto_agent_proto_rawDesc), len(file_proto_agent_proto_rawDesc)),
|
|
NumEnums: 0,
|
|
NumMessages: 3,
|
|
NumExtensions: 0,
|
|
NumServices: 1,
|
|
},
|
|
GoTypes: file_proto_agent_proto_goTypes,
|
|
DependencyIndexes: file_proto_agent_proto_depIdxs,
|
|
MessageInfos: file_proto_agent_proto_msgTypes,
|
|
}.Build()
|
|
File_proto_agent_proto = out.File
|
|
file_proto_agent_proto_goTypes = nil
|
|
file_proto_agent_proto_depIdxs = nil
|
|
}
|