> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/stackai-computer.md).

# StackAI Computer

Tools for interacting with a sandbox environment.

> **Availability depends on your environment.** If a StackAI Computer action is unavailable or reports that its sandbox is not configured, check with your workspace administrator.

## Work with uploaded files

**Terminal** can inspect workflow uploads, perform calculations, and create files for download. The setup includes the Files input, agent references, **File Access**, and interface mappings. Follow [Let an agent work with uploaded files](https://docs.stackai.com/guides-and-quickstarts/interfaces-and-end-user-experiences/let-an-agent-work-with-uploaded-files.md) for the complete walkthrough.

## Connectors

This provider has no standalone connector in the StackAI catalog. Configure any access or service settings in the selected action or feature, using its field reference below.

## Use an action

1. Add the required **StackAI Computer** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Terminal

Execute commands in a StackAI Sandbox

#### Inputs

| Field               | Type    | Required | Description                                                                            |
| ------------------- | ------- | -------- | -------------------------------------------------------------------------------------- |
| Description         | string  | No       | Short description of what this command does. Default: .                                |
| Command             | string  | Yes      | The terminal command to execute.                                                       |
| Terminal Sandbox ID | string  | No       | Optional terminal sandbox ID to reuse an existing sandbox.                             |
| Enable New Files    | boolean | No       | Download files created in the sandbox so downstream nodes can use them. Default: true. |

#### Outputs

| Field               | Type          | Description                                                    |
| ------------------- | ------------- | -------------------------------------------------------------- |
| Standard Output     | textarea      | The standard output from the command.                          |
| Standard Error      | textarea      | The standard error output from the command.                    |
| Exit Code           | integer       | The exit code of the command.                                  |
| Success             | boolean       | Whether the command executed successfully (exit code 0).       |
| Terminal Sandbox ID | string        | The ID of the terminal sandbox used for this operation.        |
| New Files Created   | object\_array | List of new files created during command execution.            |
| Image Data          | object\_array | Base64-encoded image data from files created during execution. |

### Canvas Share File

Share a file from the sandbox to the canvas

**Requirements:** {"required\_tools": \[{"provider\_id": "computer", "action\_id": "terminal", "reason": "The terminal action is required to create or update the file in the sandbox."}], "enable\_sso": true, "test\_action\_unsupported\_configurations": {}}

#### Inputs

| Field               | Type   | Required | Description                                 |
| ------------------- | ------ | -------- | ------------------------------------------- |
| Description         | string | Yes      | Short intent label shown in UI.             |
| File Path           | string | Yes      | Absolute sandbox path of the file to share. |
| Terminal Sandbox ID | string | Yes      | Sandbox ID to reuse an existing sandbox.    |

#### Outputs

| Field               | Type    | Description                               |
| ------------------- | ------- | ----------------------------------------- |
| Success             | boolean | Whether the file was shared successfully. |
| File ID             | string  | The canvas file ID.                       |
| Workspace ID        | string  | The canvas workspace ID.                  |
| Sandbox Path        | string  | The file path in the sandbox.             |
| Version             | integer | The file version number.                  |
| Terminal Sandbox ID | string  | The sandbox ID used for this operation.   |
| Error               | string  | Error message if the operation failed.    |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/stackai-computer.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
