internal/website/docs/guides/no-secret-first-agent.md
This is the fastest first-agent success path when you do not have a provider key
handy. It starts from the maintained examples/support app and uses the
repository harness that CI already runs: real Go Micro services, registry,
broker, client, store, agent loop, flow handoff, and guardrail code with only the
LLM provider mocked.
Use it before the live-provider Your First Agent walkthrough when you want to see the services → agents → workflows lifecycle run end to end with no secrets.
customers, tickets, and notify endpoints.support agent discovers those endpoints as tools and uses them to
triage a ticket.intake flow turns a ticket.created event into an agent run.From a fresh clone of the repository:
git clone https://github.com/micro/go-micro.git
cd go-micro
go run ./examples/support
The default provider is mock, so the command does not need ANTHROPIC_API_KEY,
OPENAI_API_KEY, or any other secret. A healthy run prints the event, service
calls, guardrail decision, and final support-agent reply in one terminal:
> event: events.ticket.created {"id":"ticket-1","customer":"[email protected]",...}
[customers] looked up Alice (pro plan)
[tickets] ticket-1 → priority=high status=in_progress
▣ approval gate notify_NotifyService_Send([email protected]) — approved
[notify] 📨 [email protected]: "Hi Alice — thanks for reaching out..."
support agent: Hi Alice — thanks for reaching out...
✓ ticket triaged and the customer was replied to — triggered by an event
That single run is the no-secret version of the first-agent loop: a service capability exists, an agent calls it as a tool, and workflow infrastructure can trigger and inspect the work.
Run the same deterministic path as a focused test:
go test ./examples/support -run TestRunSupportMockSmoke -count=1
For the broader no-secret contract that also checks scaffold, chat/inspect CLI boundaries, flow history, deploy dry-run, and mock provider conformance, run:
make harness
When you are ready to build the smaller live-agent version yourself, follow
Your First Agent. The command shape is the same, but a
live micro chat turn needs a provider key because the model is no longer
mocked:
micro agent preflight
micro run
micro chat assistant
micro inspect agent assistant
CI keeps those CLI boundaries present with:
go test ./cmd/micro -run TestFirstAgentWalkthroughCLIBoundaries -count=1
If chat behaves unexpectedly, continue to Debugging your agent for provider checks, run history, memory, and tool-call inspection.