micro--go-micro/examples/first-agent

First Agent

This is the smallest runnable service-backed agent in the repository. It sits between micro new helloworld and the full examples/support 0→hero reference.

It runs with a deterministic mock model, so you do not need ANTHROPIC_API_KEY, OPENAI_API_KEY, or any other provider secret.

go run ./examples/first-agent

Expected transcript:

First agent (provider: mock, no API key)
> Summarize my next steps
  [notes] listed starter notes
assistant: Your first agent read the notes service and found three steps: install the CLI, run a service, then chat with an agent.
✓ service-backed agent completed without provider secrets

What it demonstrates

• notes is a normal Go Micro service with one RPC method.
• assistant is an agent scoped to that service via agent.Services("notes").
• The mock model requests the service tool through the normal agent tool handler.
• The final answer proves the service → agent path without a live model key.

CI keeps this path runnable with:

go test ./examples/first-agent

Next chat, inspect, and debug breadcrumbs

This example exits after one in-process assistant.Ask call so it stays tiny and provider-free. When you move from this transcript to a long-running agent, keep these commands nearby:

micro run
micro chat assistant --prompt "Summarize my next steps"
micro inspect agent assistant
micro agent doctor assistant

Use the no-secret first-agent guide to compare this transcript with the CLI demo, then keep the debugging guide open for preflight, doctor, inspect, and history checks. After that, continue to examples/support for the full services → agents → workflows lifecycle with a flow trigger and an approval gate.