# LLMs
Source: https://docs-insights.petasight.com/admin/llms



## Coming Soon

Insights by PetaSight supports the LLM service of your choice:

* **Third Party Providers**: Support for other common and prominent LLM providers such as
  Anthropic and OpenAI.
* \*\* Your Hosted LLMs\*\*: For example, we can route all requests through AWS
  Bedrock on your cloud.
* **On-Premise LLMs**: Provision of Docker images of open weight LLMs (e.g.
  Llama3) running on a popular service (e.g. Ollama).


# Metrics
Source: https://docs-insights.petasight.com/admin/metrics



1. Visit the Administration page.

## Add a Metric

1. Click on 'Add New Row'.
2. Fill in the Friendly Name of the metric and the SQL to pull it from your data
   source, then hit "Update Metric".

<img />

## Update a Metric

1. Click on the field you want to edit, and modify it.

<img />

# DANGER ZONE

## Delete a Metric

1. Select the relevant Metric,
   then Click "Delete".

<img />

2. Confirm your decision, and the metric will be deleted.

<img />


# Data Sources
Source: https://docs-insights.petasight.com/admin/sources



# Sources Supported

Insights by PetaSight currently supports the following Data Sources:

* Databricks
* Google Sheets

**Credentials are NOT transmitted to or stored on Insights by PetaSight' servers.**

# Danger Zone

1. Visit the Data Source Administration page.

<img />

## Add or Update a Source

1. Select your Data Source, and hit Submit.

<img />


# User Management
Source: https://docs-insights.petasight.com/admin/users



1. To invite a new user or add an existing user to a Project that you
   administer, select the "Manage" button on the Project dropdown.

<img />

2. In the ensuing popup, you can manage the Project's details, invite new users
   and change permission levels of existing users.

<img />


# Sign In
Source: https://docs-insights.petasight.com/auth/sign-in



1. Visit [https://app.insights.petasight.com/sign-in](https://app.insights.petasight.com/sign-in) to sign in to your Insights by PetaSight account.

<img />

2. Enter your email address and password, or use one of the Connected Accounts
   (e.g. Google or GitHub) to login to your account.


# Sign Out
Source: https://docs-insights.petasight.com/auth/sign-out



1. Click on the *Profile icon* on the top right corner of the screen. Then click
   "Sign Out".

<img />

2. You will be redirected back to the [Sign In](auth/sign-in) page.


# Sign Up
Source: https://docs-insights.petasight.com/auth/sign-up



1. Visit [https://app.insights.petasight.com/sign-up](https://app.insights.petasight.com/sign-up) to sign up for a Insights by PetaSight account.

<img />

2. Enter your email address and password (you may need to validate your email
   address). Or use one of the third party account providers (e.g. Google or GitHub) to create your account.

*HINT: You can also access the Sign Up page via the [Sign In](/auth/sign-in) page, which [https://www.babba.age/](https://www.babba.age/) redirects you to in case you are not already logged in.*


# Insights
Source: https://docs-insights.petasight.com/insights



# Available at *[https://app.insights.petasight.com/](https://app.insights.petasight.com/).*

# Usage

## Authentication

Learn how to [sign up](auth/sign-up), [sign in](auth/sign-in) and [sign out](auth/sign-out).

## User Insights

If you're a new *User*, you should [join a Project](user/projects) or two. And
optionally, manage your [personal Profile](user/profile) and [personal Metrics](user/metrics).

Then, head straight to [your Insights](user/insights)!

## Administration

If you're an *Administrator*:

* help [your users](admin/users) join a Project or two, and
* manage the [Data Sources](admin/sources), [Metrics](admin/metrics) and [LLMs](admin/llms) associated with the Projects you administer.

# Company

Learn about Insights by PetaSight' [Tooling Infrastructure](tooling)!

Links to this *Documentation*, our [Terms of Service](https://www.petasight.com/terms) and [Privacy Policy](https://www.petasight.com/privacy)
are also available via links in the Newspaper.


# Tooling
Source: https://docs-insights.petasight.com/tooling



## Primary Tooling

| **Service**               | **Tool**                        | **Purpose**                                                                                                                | **Location**      |
| :------------------------ | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| Analytics                 | DuckDB                          | Analytical work (OLAP).                                                                                                    |                   |
| Compute                   | Linux instance                  | CPU-intensive computations. Backend orchestration.                                                                         | *us-east-2* (AWS) |
| Database                  | PostgreSQL                      | Relational database to store generated insights for APIs and the frontend.                                                 | *us-east-2* (AWS) |
| LLM                       | OpenAI                          | LM for prompting and fine-tuning. Currently, Insights by PetaSight only supports OpenAI.                                   |                   |
| User & Project Management | [Clerk](https://www.clerk.com/) | Maintain users and projects.                                                                                               |                   |
| Data Sources              | Databricks, Google Sheets       | Pulling data from the project source, for analysis. **User Credentials are NOT stored on Insights by PetaSight' servers.** |                   |

## Support Tooling

| **Service**   | **Tool**                              | **Purpose**    |
| :------------ | :------------------------------------ | :------------- |
| Hosting       | [Vercel](https://www.vercel.com/)     | Insights.      |
| Documentation | [Mintlify](https://www.mintlify.com/) | Documentation. |


# My Insights
Source: https://docs-insights.petasight.com/user/insights



## Introduction

**This is the "home" page of the Company Newspaper.** It is the first page that users
see when they first visit the Newspaper or switch to a different Project.

It is where you manage, and investigate all the Insights that Insights by PetaSight
produces.

## Steps

1. View the list of Insights as a "story", i.e. a series of blog posts.

<img />

3. Click on the **title of an Insight** to view it in its own page. *You can share that URL as a permalink; be assured that only permissioned users will be allowed to access it.*

<img />

## Feature Highlights

* **Insight Flow**: No more static insights! Insights by PetaSight will carefully
  curate your insights so that you see a streamlined narrative that evolves with
  your data. If you saw an insight before, you won't see it again unless it
  becomes significant once again. You thus only ever see only the most relevant and impactful insights.

<img />

* **Personal Queries**: Free-form queries to dive deeper into a particular insight.
  Insights by PetaSight will generate the top 3 follow-up queries that require investigation. (In a future release, we will also allow "Co-Pilot" functionality, or
  free-form querying of the Insight.)

<img />

* **Extract**: One-click extraction of the pivoted data that underlies a particular
  insight.

<img />


# My Metrics
Source: https://docs-insights.petasight.com/user/metrics



## Coming Soon

* **My Personal Metrics**: A user's insights get prioritized or deprioritized
  based on the metrics they choose to be relevant to them!

## Steps

1. You can select, add and edit metrics on your own personal page:

<img />


# Profile
Source: https://docs-insights.petasight.com/user/profile



1. Click on the Profile icon on the top right corner of the screen. Then click
   on **your name + email** (the first item in the dropdown).

<img />

*In this page, you can update various personal details including your Connected Accounts, email addresses, and profile image. Your multi-factor authentication (MFA/2FA) settings are also available here.*


# Select Project
Source: https://docs-insights.petasight.com/user/projects



1. Pick your Projects from the available ones.

<img />

*If you don't see the Project you want, contact your Administrator or the Insights by PetaSight team.*


# Welcome
Source: https://docs-insights.petasight.com/welcome



<img />

## What is Insights by PetaSight?

Insights by PetaSight is your **Instant Company Newspaper**, enabled by an Instant AI
Data Analyst Team. It continuously
monitors your data and provides you *exceptional insights* about your business.

## Join Us!

To start a trial, or get a demo, [**contact the Insights by PetaSight team**](mailto:team@petasight.com) right now!

## How does it work?

You simply tell us your *high-level* key business metrics, and the queries to
compute them.

"High level" means we only want the top-level metrics. For example, one metric
each for revenue, profit margins, customer acquisition cost, and churn rate. No need to go any deeper.

Insights by PetaSight then figures out the intricacies of your data. It will track
your metrics, and (like a **good** Chief Analytics Officer) *anticipate* the
questions you might ask. It asks those questions, answers them, and generates
periodic reports that include *exceptional insights*.

For example, you add metrics like this:

<img />

That's it. Disaggregations, correlations, "trees" - Insights by PetaSight figures all
those out itself.

Then, your entire company gets its own personalized, continuously updating **Newspaper**:

<img />

Each user gets their own, personally customized version of these reports.

[**Get in touch!**](mailto:team@petasight.com)