Developer guide
Build, test and ship governed agents step by step: local environment, tool and model calls, decisions, tests and deployment.
Build on MAQPNAWhat a governed agent is, the developer workflow from first line of code to production, and which path to take for your language or framework.Set up your development environmentInstall the maqpna CLI, start a local MAQPNA with maqpna dev up, check it, use contexts and MAQPNA Desk, and tear it down.Anatomy of an agent projectThe code, image and manifests that make up a governed agent, how the MAQPNA resources relate, how to scaffold them with maqpna init, and a complete minimal set that validates.Connect to the gatewayHow an agent gets its session identity and token, the environment variables and endpoints it is given, how long a token lives and how it is refreshed.Call tools over MCPList and call tools through the MAQPNA gateway from Python, TypeScript, Go or raw JSON-RPC over HTTP, read the result, and work with pinned tools.Call models through the gatewaySend model calls to the gateway's /llm route with the OpenAI or Anthropic wire format, point existing SDKs at it, and know which budgets, token limits and DLP checks apply.Handle decisions in codeReact to allowed, denied, held-for-approval, budget-exceeded and revoked calls in Python, TypeScript, Go and raw HTTP, with the error envelope, retry guidance and approval waits.Call another agentCall a hosted agent or a remote A2A peer through the gateway from code, act on the caller's behalf with delegation, and see what the audit ledger records.Test agents and policiesCheck manifests and policies offline, test agent code against a local gateway, and run the same checks in a GitHub Actions pipeline.Package and deployBuild a container image that runs in a MAQPNA sandbox, apply the Agent and its policy to a cluster, promote it from dev to staging to production, and run it with GitOps.Debug and observeFind out what a session did and why a call was denied, with the timeline, the audit ledger, sandbox logs, events and OpenTelemetry GenAI traces.CookbookShort, tested recipes for common developer tasks with MAQPNA, from read-only tools and approval thresholds to spend caps, DLP, revocations and evidence export.