Workflow guide
Prepare your workspace
Confirm the environment, permissions and data boundary before the first workflow.
Confirm the enabled version and permissions in your environment. These guides do not announce a general release.
Before you start
An API environment, a valid identity, a flow definition and credentials for only the providers the flow needs. Use the environment-specific OpenAPI contract.
Steps
- Record the environment, product version, responsible owner and permitted data. Keep credentials outside the document.
- Select the environment and a versioned flow definition. Start with a deterministic step before adding a model or tool with side effects.
- Scope tool capabilities and budgets to the agent. Keep secrets in deployment configuration; do not insert them into prompts or exported traces.
Check the result
Compare the observed outcome with the expected result. Keep the relevant identifier and a redacted record so a colleague can review the same case.
If it does not work
Use run, flow and correlation identifiers to distinguish input validation, model/provider, tool and worker failures. Confirm run state before retrying.
