> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roe-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Functional References

### Getting Started

1. **Initialization**: When you first open the app, it initializes the necessary services. This can also be done by calling the `start_app` procedure.

2. **Navigation**: Use the sidebar to switch between different sections of the app:
   * **Files**: Manage and import files.
   * **Agents**: Create and manage agents.

### Files Tab

* **Importing Files**: You can import files from a stage by providing the stage name and the relative file path. Click "Import File" to execute the import.
* **Listing Files**: The app lists files available in the storage stage. You can open these files using presigned URLs.

### Agents Tab

* **Add Agent**: Click "Add Agent" to create a new agent. Fill in the agent's details, including name, description, and engine class ID.
* **Update Agent**: Select an existing agent to update its configuration.
* **Agent Configuration**: Define input parameters and engine configurations for your agents.

## Functions and Procedures

The app provides several functions and procedures to interact with your data and manage services:

### Procedures

* **`app_public.start_app()`**: Initializes the app services, including compute pools and services.
* **`app_public.service_status()`**: Returns the status of the core Roe service.
* **`app_public.load_file(stage_name, relative_file_path)`**: Loads a file from a specified stage into the app's storage.

### Functions

* **`core.list_files()`**: Returns a list of files stored in the app's stage.
* **`core.create_agent(config)`**: Creates a new agent with the specified configuration.
* **`core.update_agent(agent_id, config)`**: Updates an existing agent with new configuration details.
* **`core.get_agent(agent_id)`**: Retrieves the configuration of a specified agent.
* **`core.list_agents()`**: Lists all agents available in the app.
* **`core.run_agent(agent_id, inputs)`**: Executes an agent with the provided inputs.