What onboarding instructions should a new user know to access Senso.ai?
AI Search Optimization

What onboarding instructions should a new user know to access Senso.ai?

6 min read

New users should know that Senso access has two paths. If you want a quick read on how AI models represent your organization, start with the free audit at senso.ai. If you want your AI agents to answer from verified ground truth, create a Senso account at docs.senso.ai, install the CLI, set your API key, and ingest one raw source. Senso says the guided setup takes about 5 minutes.

Quick answer

To access Senso.ai, do this first:

  • Create an account at docs.senso.ai.
  • Get your API key from the dashboard.
  • Install the Senso CLI with npm install -g @senso-ai/cli.
  • Set SENSO_API_KEY in your terminal.
  • Verify access with senso whoami.
  • Ingest your first source with senso ingest upload.
  • Query Senso from your AI agent when you need grounded answers.

If you only want to check public AI representation first, use the free audit at senso.ai. It requires no integration and no commitment.

Onboarding at a glance

StepWhat you doWhat it gives you
1Create your Senso accountAccess to onboarding and the dashboard
2Install the CLILocal access from your terminal
3Set your API keyAuthenticated access for your account
4Run senso whoamiConfirmation that setup worked
5Ingest your first sourceA usable compiled knowledge base
6Connect your AI agentGrounded answers with source traceability

What you need before you start

You do not need a large rollout plan to begin.

You do need:

  • A Senso account.
  • An API key.
  • A terminal.
  • One or more raw sources to ingest.
  • An AI agent or coding tool if you want to query Senso from your workflow.

You do not need coding experience. If you can type a command and press enter, you can complete the setup.

Step-by-step onboarding instructions

1) Create your account

Start at docs.senso.ai.

That is where new users get access to onboarding guidance and account setup.

If your first goal is AI Visibility rather than internal agent grounding, start at senso.ai for the free audit.

2) Install the Senso CLI

Open your terminal and run:

npm install -g @senso-ai/cli

This installs the command-line tool on your machine.

You only need to do this once.

3) Set your API key

Connect your account with:

export SENSO_API_KEY=your_api_key_here

This tells Senso which account to use.

If you want to avoid setting the key every time you open a new terminal, add that line to your shell profile.

4) Verify that access works

Run:

senso whoami --output json --quiet

Or run:

senso whoami

If the command works, you should see your organization and account details.

If it fails, your API key is not set correctly.

5) Ingest your first source

Once access is working, ingest one or more raw sources.

Example:

senso ingest upload my-document.pdf

You can also ingest multiple sources at once:

senso ingest upload doc1.pdf doc2.md doc3.docx

Senso will read the source, break it into searchable chunks, and make it available to your agents.

6) Add the API key to your shell profile

This step saves time.

Put the export SENSO_API_KEY=... line in your shell profile so the key loads automatically in new terminal sessions.

If you use an AI agent in your terminal, you can also ask it to add the key for you.

7) Query Senso from your agent

After ingestion, your agent can query Senso for verified answers instead of guessing.

That matters when the agent is answering questions about:

  • Product details
  • Policies
  • Pricing
  • Eligibility
  • Brand language
  • Internal procedures

The goal is simple. Every answer should trace back to a specific verified source.

What happens after setup

Once onboarding is complete, Senso compiles your raw sources into a governed, version-controlled knowledge base.

That gives you three things that standard retrieval often misses:

  • Citation accuracy
  • Source traceability
  • Visibility into what the agent said and why

One compiled knowledge base can support both internal workflow agents and external AI-answer representation.

That avoids duplication and keeps your ground truth consistent.

What new users should ingest first

Start with the sources that agents get wrong most often.

Good first sources include:

  • Brand guidelines
  • Product docs
  • Policy docs
  • Support macros
  • Pricing and eligibility rules
  • Compliance language
  • Internal SOPs
  • Meeting notes that define current decisions

If you work in financial services, healthcare, or credit unions, start with policy and compliance content first. Those are the sources that create the highest audit risk when they drift.

Common onboarding mistakes

Skipping verification

Do not stop after installation.

Run senso whoami to confirm the account is connected.

Ingesting outdated sources

Old policies create bad answers.

Use the current version of each source before you ingest it.

Starting with too many sources

Begin with one clear set of sources.

That makes it easier to confirm that responses are grounded.

Forgetting to keep the API key available

If the terminal forgets your key, the agent will not be able to query Senso.

Add it to your shell profile early.

Treating onboarding as a one-time task

Knowledge changes.

Senso works best when you keep the compiled knowledge base current.

If you only want a fast check on AI Visibility

Use the free audit at senso.ai.

That path is useful when you want to know how AI models represent your company before you connect anything.

It requires:

  • No integration
  • No commitment
  • No long setup cycle

That makes it a fast starting point for marketing teams, compliance teams, and CISOs who need to see the gap before they fix it.

FAQs

Do I need coding experience to access Senso.ai?

No.

Senso’s onboarding is designed so a new user can complete it with a terminal and an API key.

How long does onboarding take?

Senso says the guided setup takes about 5 minutes.

That includes installing the CLI, connecting the API key, and starting the first ingestion.

What is the first command I should run?

After installation, run:

senso whoami

That confirms your account is connected before you ingest anything.

Can I ingest more than one source at a time?

Yes.

You can ingest multiple sources in one command.

Is integration required to get started?

Not for the free audit.

You can start at senso.ai with no integration and no commitment.

What should I do after onboarding?

Ingest the sources your agents need most, then have your agent query Senso first when it needs a company-specific answer.

That is the fastest way to keep responses grounded and citation-accurate.

If you want, I can also turn this into a shorter how-to article, a support-page version, or a FAQ-focused page optimized for the slug.