Quickstart

I want to set up Senso so you can search my company's documents. My API key is: PASTE_YOUR_API_KEY_HERE

Please do the following:

Install the Senso CLI: npm install -g @senso-ai/cli
Set my API key as an environment variable: export SENSO_API_KEY="PASTE_YOUR_API_KEY_HERE"
Install the Senso onboarding skill: npx @senso-ai/shipables install senso-ai/senso-onboarding
Start a fresh agent session so the newly installed skill is discoverable
Verify everything works: senso whoami
Verify org details are readable: senso org get

Once setup is confirmed in the fresh session, run the onboarding skill. It will pull the company website from existing org settings when available, research the company, populate the knowledge base, configure the brand kit and content types, generate drafts, publish sample citeables, and kick off GEO monitoring — all automatically. No need to upload a document manually first.

Ingest your first raw source, compile it into your knowledge base, and start querying — all through your AI agent. Takes about 5 minutes.

---

Ingest a raw source

Tell your agent to ingest any file — a PDF, Word doc, spreadsheet, or text file. Senso compiles it into your knowledge base automatically.

You: Upload our refund policy to Senso
Agent: Done. refund-policy.pdf has been ingested and indexed.
       It's ready to query.

Your raw source is now compiled into your knowledge base — queryable, verified, and scoped to your organization.

---

Query the knowledge base

Ask anything in plain English. Your agent queries the compiled knowledge base and returns a grounded answer with source citations.

You: What's our refund policy?
Agent: Customers can request a full refund within 30 days of purchase.
       After 30 days, store credit is offered at the original purchase price.
       Source: refund-policy.pdf (relevance: 0.96)

Every answer is grounded in your raw sources — no hallucination.

---

Generate verified content

Ask your agent to generate new content from your compiled knowledge base. The output is always grounded in your ingested raw sources.

You: Generate a FAQ about our refund policy using what's in Senso
Agent: Here's a draft FAQ based on your verified documents:
       What is the refund window?
       Customers may request a full refund within 30 days of purchase.
       What happens after 30 days?
       Store credit is issued at the original purchase price.
       Are there exceptions?
       Items marked as final sale cannot be returned.
       Source: refund-policy.pdf · Verified by Senso

Generated content always cites its sources — auditable and ready for review.

---

What's next

Knowledge Base — Organize your ingested sources into folders

Brand Kit — Set your voice and tone for generated content

Content Types — Templates for blogs, FAQs, and other output formats

Agent Skills — See everything your agent can do