{"schemaVersion":"1","contentVersion":"2026-10-18.1","slug":"controls-workflow-agents","title":"AI workflow step and connector controls","summary":"Choose an AI model, tools, output format, and payer, or configure a service connector’s operation and credentials.","category":"Control reference","minutes":5,"prerequisites":["Open the named screen in Rumata. Available controls may depend on your account, permissions, and resource state."],"sections":[{"id":"agent","title":"AI Agent instructions and tools","blocks":[{"type":"paragraph","text":"An AI step runs inside your automation. The assistant you chat with to build your app works separately."},{"type":"table","headers":["Control","What it does"],"rows":[["System prompt","Describe what this step should accomplish, which rules it must follow, and when it should finish."],["Model","Enter the model identifier to use. Use a model available through the configured provider."],["Max turns","Limit how many reasoning/tool rounds this step can take. The default is 6."],["Tools search / activity checkbox","Find and enable the activities the AI is allowed to call. Uncheck one to remove it from the tool set."],["Selected tool configuration","Complete the selected activity’s settings. The AI receives the configured tool when the workflow runs."]]}]},{"id":"output","title":"Final answer format","blocks":[{"type":"paragraph","text":"Choose a consistent format for the data passed to the next step so it can use the result reliably."},{"type":"table","headers":["Control","What it does"],"rows":[["Text","Return a text answer."],["JSON object","Return a structured object; this is the default mode."],["JSON Schema","Require a structured answer that satisfies the schema you provide."],["Schema editor","Enter a JSON object defining the expected fields and rules. Leave the field to validate and apply it to the graph draft; fix any error before saving."]]}]},{"id":"billing","title":"Who pays and advanced settings","blocks":[{"type":"paragraph","text":"Review the payer before publishing a workflow other people can call."},{"type":"table","headers":["Control","What it does"],"rows":[["Caller funded / Owner funded","Choose whether the caller or workflow owner pays for this AI step. [Caller funded](/guides/controls-workflow-agents#billing) is the default."],["Keep caller funded / Enable owner funded","Cancel or accept the owner-funding choice in its confirmation dialog. The setting is still part of the graph draft until [Save](/guides/controls-workflows#toolbar)."],["Advanced → Maximum run cost (USD)","Set a cost ceiling for this agent run. Leaving it blank removes this explicit ceiling."],["Tool local URL override","For development, route tool calls to a specified service address."],["OpenRouter API key / project secret toggle","Provide your own key directly or through a project secret, or leave it blank to use the platform configuration."]]}]},{"id":"connectors","title":"Service connectors","blocks":[{"type":"paragraph","text":"[Connectors](/guides/controls-connectors#catalog) provide named operations for external services. Add one from [Add step](/guides/controls-workflow-palette#catalog), then choose an operation and complete the fields shown for it."},{"type":"table","headers":["Control","What it does"],"rows":[["Connector / operation","Choose the service and task to perform. Changing the operation changes the available fields and the request it sends."],["Required operation fields","Complete fields marked with an asterisk. Their descriptions identify the required service IDs, content, or other values."],["Body field → ƒx","Calculate a request-body value from the current run with JSONata."],["Path or query field → key icon","Use a project secret for a value placed in the address or query parameters."],["Credential / API key → key icon","Choose a saved secret rather than embedding the credential in the graph. The helper text says which header or query parameter receives it."],["Secret selector / Use a fixed value","Pick a secret by name, or return to a fixed value. Switching secret mode clears the prior field value."]]}]}],"technical":[],"related":["controls-workflow-nodes","controls-workflow-runs","system-explorer-secrets"],"sources":["components/window/explorer/graph-workflows/node-config/AgentSection.tsx","components/window/explorer/graph-workflows/node-config/AgentOutputSection.tsx","components/window/explorer/graph-workflows/node-config/connector-fields.tsx","components/window/explorer/graph-workflows/node-config/HttpSection.tsx"],"updated":"2026-09-06","audience":"general","media":[],"video":null,"url":"https://docs.rumata.dev/guides/controls-workflow-agents"}