mirror of
https://github.com/go-micro/go-micro.git
synced 2026-06-15 19:35:13 +02:00
* docs: update all four documentation guides and mark Q2 complete - ai-native-services: add WithMCP one-liner, standalone gateway, WebSocket client example, and OpenTelemetry observability section - mcp-security: add OTel distributed tracing, WebSocket authentication (connection-level and per-message), DeniedReason audit field - tool-descriptions: add manual overrides with WithEndpointDocs and export formats section - agent-patterns: add LangChain/LlamaIndex SDK pattern and standalone gateway production pattern with Docker example - Update roadmap: mark Q2 documentation as complete, Q2 at 100% - Update status: reflect all recent completions, shift priorities https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add agent demo example and blog post Add examples/agent-demo with a multi-service project management app (projects, tasks, team) that demonstrates AI agents interacting with Go Micro services through MCP. Includes seed data and example prompts. Add blog post 4 "Agents Meet Microservices: A Hands-On Demo" walking through the example code and showing cross-service agent workflows. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: enable multiple services in a single binary Remove global state mutations from service and cmd option functions so that configuring one service no longer overwrites another's settings. Key changes: - service/options.go: remove all DefaultXxx global writes from option functions; newOptions() now creates fresh Server, Client, Store, and Cache per service while sharing Registry, Broker, and Transport - cmd/cmd.go: newCmd() uses local copies instead of pointers to package globals; Before() no longer mutates DefaultXxx vars - cmd/options.go: remove global mutations from all option functions - service/service.go: export ServiceImpl type for cross-package use - service/group.go: new Group type for multi-service lifecycle - micro.go: add Start/Stop to Service interface, expose Group and NewGroup convenience function - examples/multi-service: working example with two services https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * docs: highlight multi-service binary support Add multi-service section to README with code example, update features list, add to examples index, and note in status summary. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: unify service API and clean up developer experience - Unified service creation: micro.New("name", opts...) as canonical API - Clean handler registration: service.Handle(handler, opts...) accepts server.HandlerOption args directly, no need to reach through Server() - Unexported serviceImpl: users interact through Service interface only - Service groups use Service interface (not concrete type) - Fixed Stop() to properly propagate BeforeStop/AfterStop errors - Fixed store init: error-level log instead of fatal on init failure - Updated all examples to use consistent patterns - Updated README, getting-started, MCP docs, and guides - Added blog post about the DX cleanup https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * fix: add blog post 5 to blog index Blog post 5 (Developer Experience Cleanup) existed as a file but was missing from the blog index page. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: make micro new generate MCP-enabled services by default - main.go template includes mcp.WithMCP(":3001") by default - Handler template has agent-friendly doc comments with @example tags - Proto template has descriptive field comments - README includes MCP usage, Claude Code config, and tool description tips - Makefile adds mcp-tools, mcp-test, mcp-serve targets - go.mod updated to Go 1.22 - Added --no-mcp flag to opt out of MCP integration - Post-create output shows MCP endpoint URLs https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * docs: add MCP migration guide and troubleshooting guide - Migration guide: 3 approaches to add MCP to existing services (WithMCP one-liner, standalone gateway, CLI) - Troubleshooting guide: common issues with agents, WebSocket, Claude Code, auth, rate limiting, and performance https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * refactor: rename model/ package to ai/ for AI model providers The model/ package name conflicted with the conventional use of "model" for data models. Renamed to ai/ which better describes the package's purpose (AI provider abstraction for Anthropic, OpenAI, etc.) and frees up model/ for future data model layer use. - Rename model/ → ai/ with package name change - Update all Go imports from go-micro.dev/v5/model to go-micro.dev/v5/ai - Update cmd/micro/server/server.go references (model.X → ai.X) - Update all documentation and roadmap references - All tests pass, CLI builds successfully https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add model package for typed data access with CRUD and queries New model/ package provides a typed data model layer using Go generics. Supports structured CRUD operations, WHERE filters, ordering, pagination, and automatic schema creation from struct tags. Three backends: - memory: in-memory for development and testing - sqlite: embedded SQL for dev and single-node production - postgres: full PostgreSQL for production deployments Key features: - Generic Model[T] with Create/Read/Update/Delete/List/Count - Query builder: Where(), WhereOp(), OrderAsc/Desc(), Limit(), Offset() - Struct tags: model:"key" for primary key, model:"index" for indexes - Auto table creation from struct schema - 19 tests passing across memory and sqlite backends https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add model code generation to protoc-gen-micro Extend the micro plugin to generate model structs from proto messages annotated with // @model. Generated alongside client/server code in the same .pb.micro.go file. For a proto message like: // @model message User { string id = 1; string name = 2; } Generates: - UserModel struct with model:"key" and json tags - NewUserModel(db) factory returning *model.Model[UserModel] - UserModelFromProto(*User) *UserModel converter - (*UserModel).ToProto() *User converter Supports @model(table=custom_table, key=custom_field) options. Adds GetComments() to generator for plugin comment inspection. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc * feat: add Model() to Service interface for Client/Server/Model trifecta Every service now exposes Client(), Server(), and Model() — call services, handle requests, and save/query data from the same interface. Includes README docs, blog post, and a full model guide on the docs site. https://claude.ai/code/session_01GkduEhcrqcG45rdfYh8dAc --------- Co-authored-by: Claude <noreply@anthropic.com>
228 lines
5.6 KiB
Go
228 lines
5.6 KiB
Go
// Package anthropic implements the Anthropic Claude model provider
|
|
package anthropic
|
|
|
|
import (
|
|
"bytes"
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"net/http"
|
|
"strings"
|
|
|
|
"go-micro.dev/v5/ai"
|
|
)
|
|
|
|
func init() {
|
|
ai.Register("anthropic", func(opts ...ai.Option) ai.Model {
|
|
return NewProvider(opts...)
|
|
})
|
|
}
|
|
|
|
// Provider implements the ai.Model interface for Anthropic Claude
|
|
type Provider struct {
|
|
opts ai.Options
|
|
}
|
|
|
|
// NewProvider creates a new Anthropic provider
|
|
func NewProvider(opts ...ai.Option) *Provider {
|
|
options := ai.NewOptions(opts...)
|
|
|
|
// Set defaults if not provided
|
|
if options.Model == "" {
|
|
options.Model = "claude-sonnet-4-20250514"
|
|
}
|
|
if options.BaseURL == "" {
|
|
options.BaseURL = "https://api.anthropic.com"
|
|
}
|
|
|
|
return &Provider{
|
|
opts: options,
|
|
}
|
|
}
|
|
|
|
// Init initializes the provider with options
|
|
func (p *Provider) Init(opts ...ai.Option) error {
|
|
for _, o := range opts {
|
|
o(&p.opts)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// Options returns the provider options
|
|
func (p *Provider) Options() ai.Options {
|
|
return p.opts
|
|
}
|
|
|
|
// String returns the provider name
|
|
func (p *Provider) String() string {
|
|
return "anthropic"
|
|
}
|
|
|
|
// Generate generates a response from the model
|
|
func (p *Provider) Generate(ctx context.Context, req *ai.Request, opts ...ai.GenerateOption) (*ai.Response, error) {
|
|
// Build tools for Anthropic format
|
|
var anthropicTools []map[string]any
|
|
for _, t := range req.Tools {
|
|
anthropicTools = append(anthropicTools, map[string]any{
|
|
"name": t.Name,
|
|
"description": t.Description,
|
|
"input_schema": map[string]any{
|
|
"type": "object",
|
|
"properties": t.Properties,
|
|
},
|
|
})
|
|
}
|
|
|
|
// Build initial request
|
|
apiReq := map[string]any{
|
|
"model": p.opts.Model,
|
|
"max_tokens": 4096,
|
|
"system": req.SystemPrompt,
|
|
"messages": []map[string]any{
|
|
{"role": "user", "content": req.Prompt},
|
|
},
|
|
}
|
|
|
|
if len(anthropicTools) > 0 {
|
|
apiReq["tools"] = anthropicTools
|
|
}
|
|
|
|
// Make API call
|
|
resp, rawContent, err := p.callAPI(ctx, apiReq)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// If no tool calls, return response
|
|
if len(resp.ToolCalls) == 0 {
|
|
return resp, nil
|
|
}
|
|
|
|
// If tool handler is provided, execute tools and get final answer
|
|
if p.opts.ToolHandler != nil {
|
|
var toolResults []ai.ToolResult
|
|
for _, tc := range resp.ToolCalls {
|
|
_, content := p.opts.ToolHandler(tc.Name, tc.Input)
|
|
toolResults = append(toolResults, ai.ToolResult{
|
|
ID: tc.ID,
|
|
Content: content,
|
|
})
|
|
}
|
|
|
|
// Build follow-up request with tool results
|
|
var toolResultBlocks []map[string]any
|
|
for _, tr := range toolResults {
|
|
toolResultBlocks = append(toolResultBlocks, map[string]any{
|
|
"type": "tool_result",
|
|
"tool_use_id": tr.ID,
|
|
"content": tr.Content,
|
|
})
|
|
}
|
|
|
|
followUpReq := map[string]any{
|
|
"model": p.opts.Model,
|
|
"max_tokens": 4096,
|
|
"system": req.SystemPrompt,
|
|
"messages": []map[string]any{
|
|
{"role": "user", "content": req.Prompt},
|
|
{"role": "assistant", "content": rawContent},
|
|
{"role": "user", "content": toolResultBlocks},
|
|
},
|
|
}
|
|
|
|
// Make follow-up API call
|
|
followUpResp, _, err := p.callAPI(ctx, followUpReq)
|
|
if err == nil && followUpResp.Reply != "" {
|
|
resp.Answer = followUpResp.Reply
|
|
}
|
|
}
|
|
|
|
return resp, nil
|
|
}
|
|
|
|
// Stream generates a streaming response (not yet implemented)
|
|
func (p *Provider) Stream(ctx context.Context, req *ai.Request, opts ...ai.GenerateOption) (ai.Stream, error) {
|
|
return nil, fmt.Errorf("streaming not yet implemented for anthropic provider")
|
|
}
|
|
|
|
// callAPI makes an HTTP request to the Anthropic API
|
|
func (p *Provider) callAPI(ctx context.Context, req map[string]any) (*ai.Response, any, error) {
|
|
// Marshal request
|
|
reqBody, err := json.Marshal(req)
|
|
if err != nil {
|
|
return nil, nil, fmt.Errorf("failed to marshal request: %w", err)
|
|
}
|
|
|
|
// Build HTTP request
|
|
apiURL := strings.TrimRight(p.opts.BaseURL, "/") + "/v1/messages"
|
|
httpReq, err := http.NewRequestWithContext(ctx, "POST", apiURL, bytes.NewReader(reqBody))
|
|
if err != nil {
|
|
return nil, nil, fmt.Errorf("failed to create request: %w", err)
|
|
}
|
|
|
|
// Set headers
|
|
httpReq.Header.Set("Content-Type", "application/json")
|
|
httpReq.Header.Set("x-api-key", p.opts.APIKey)
|
|
httpReq.Header.Set("anthropic-version", "2023-06-01")
|
|
|
|
// Make request
|
|
httpResp, err := http.DefaultClient.Do(httpReq)
|
|
if err != nil {
|
|
return nil, nil, fmt.Errorf("API request failed: %w", err)
|
|
}
|
|
defer httpResp.Body.Close()
|
|
|
|
// Read response
|
|
respBody, _ := io.ReadAll(httpResp.Body)
|
|
if httpResp.StatusCode != 200 {
|
|
return nil, nil, fmt.Errorf("API error (%s): %s", httpResp.Status, string(respBody))
|
|
}
|
|
|
|
// Parse response
|
|
var anthropicResp struct {
|
|
Content []struct {
|
|
Type string `json:"type"`
|
|
Text string `json:"text"`
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
Input json.RawMessage `json:"input"`
|
|
} `json:"content"`
|
|
StopReason string `json:"stop_reason"`
|
|
}
|
|
|
|
if err := json.Unmarshal(respBody, &anthropicResp); err != nil {
|
|
return nil, nil, fmt.Errorf("failed to parse response: %w", err)
|
|
}
|
|
|
|
response := &ai.Response{}
|
|
|
|
// Extract text reply
|
|
var replyParts []string
|
|
for _, block := range anthropicResp.Content {
|
|
if block.Type == "text" && block.Text != "" {
|
|
replyParts = append(replyParts, block.Text)
|
|
}
|
|
}
|
|
if len(replyParts) > 0 {
|
|
response.Reply = strings.Join(replyParts, "\n")
|
|
}
|
|
|
|
// Extract tool calls
|
|
for _, block := range anthropicResp.Content {
|
|
if block.Type == "tool_use" {
|
|
var input map[string]any
|
|
if err := json.Unmarshal(block.Input, &input); err != nil {
|
|
input = map[string]any{}
|
|
}
|
|
response.ToolCalls = append(response.ToolCalls, ai.ToolCall{
|
|
ID: block.ID,
|
|
Name: block.Name,
|
|
Input: input,
|
|
})
|
|
}
|
|
}
|
|
|
|
return response, anthropicResp.Content, nil
|
|
}
|