Operate
Diagnose an integration safely.
| Symptom | What to check |
|---|---|
| Agent is not in dashboard | Run construction once; check agent:register, allowed agent ID, API URL and logged-in account. |
| Tool is missing | Pass it in the wrapped tool list and use a stable supported decorator/name. |
| Valid tool is denied | Check normalized action, active agent, synced policy, constraints and API-key ownership. |
| Key cannot execute tools | Add tool:execute and allow the connector's exact agent ID. |
| Connector not found | Enable a connector for the same workspace, agent ID and action. |
| Validate succeeds; call fails | Validate is local. Check remote DNS, firewall, TLS, credentials and service permissions using staging data. |
| Dashboard has no records | Use the account that created the API key, then press Refresh in Decisions. |
| 409 on a retry | The idempotency key was reused with different arguments. Reuse it only for the identical operation. |
| 429 or 503 | Honor Retry-After. Never bypass Quasentra by calling the original sensitive tool. |
Evidence to record
Keep timestamp, agent ID, action, request or idempotency key, reason code and HTTP status. Never include API keys, connector credentials or the gateway master key.
Safe recovery
Keep uncertain operations blocked. Reproduce with a staging agent and non-production record, then review Decisions and Incidents.
Still blocked?
Contact support with non-secret evidence and exact Quasentra and framework versions.