Developer FAQs
Every question has its own page, so a link to one answer is a link you can send.
63 of 63 questions
What is the Context Layer?A knowledge base for agents, in five sections, that the loop keeps correcting.What is ERVP?Evaluate, Remediate, Verify, Publish. The verification sequence.What is the Product Catalog?Current products, pricing, eligibility and terms, as their own section.What are Topics?The taxonomy joining questions, sources, content, evaluations and gaps.What is a gap?A factual problem found by evaluation, waiting on a decision.What is a verification receipt?Portable proof that a verification and publication event happened.What is the difference between an observation and ground truth?Your approved records are truth. What a model says is an observation.What is a Verified Source?Checked, attested, traceable. All three, or it is not one.What is an organization?The container for everything: knowledge base, keys, content, settings.What is the knowledge base?The compiled, queryable form of everything you have ingested.What is a raw source?Anything you put in before Senso processes it: a file, a page, a block of text.What does "compile" mean?Turning a raw source into something queryableWhat is a claim?A single assertion extracted from a model’s answer, with the sources behind it.What is an eval?A recorded judgement about whether a document supports a claim.What is a prompt?A question you want AI models to answer well about you.What is a prompt run?One execution of one prompt against one model, and everything it produced.What is a brand kit?Org-wide voice, tone, persona and writing rules for generated content.What is a content type?A template controlling the shape of generated output.How do credits work?Usage currency. New organizations start with $100.What is the difference between a node id and a content id?Node ids address the tree. Content ids address what you cite.Why is my document not queryable yet?Writes are asynchronous. It is stored, but compilation has not finished.Does updating a document append or replace?Replace. Passing new text overwrites the entire body.How does versioning work?Every update cuts a revision; older text stays readable.What happens if I ingest the same document twice?Nothing is created. Identical text does not produce a second copy.What happens when I delete a folder?The entire subtree goes, permanently.How do tags work?Auto-applied on creation, and settable by name or id.What makes an answer "grounded"?It is built only from your documents, and cites which ones.What happens when a search finds nothing?It files an API search gap in your gap report, so the unanswered question is not lost.What are the four query modes?content, context, answer and full. Cheapest to most thorough.Can an ingested document hijack my agent?No. Retrieved text comes back marked as data, never as instructions.What is a citation?A source a model used to support a claim in its answer.What are citation tiers?Primary, Tracked and External. Who owns the cited domain.What is Citation Rate?Of answers that cited anything, how many cited this tier.What is Citation Coverage?Of answers that cited anything, how many cited this specific source.What is Citation Share?Of all citation instances, what fraction is this tier or source.What is mention rate, and how is it different from citation?Being named is not being used as a source. Different metrics entirely.What is the IAB AI visibility framework?The shared vocabulary for AI visibility: Presence, Prominence, Portrayal, Persuasion.Does Senso’s Citation Rate match the IAB definition?No. Same name, different denominator — and mixing them silently changes the number.What is Share of Voice?Your brand mentions as a proportion of all brand mentions the models made.What is Visibility Momentum?The rate of change in visibility between periods — improving, flat or declining.What is Position, and how does Senso measure it?Where you land in an answer. Senso reports it as avg_rank, where 1 means named first.What are Sentiment and Framing?Whether you are described positively or negatively, and what role you are cast in.What is Hallucination Rate?How often a model fabricates a claim about you that no source supports.What is Factual Inaccuracy Rate, and how is it different from hallucination?The model quoted a real source correctly. The source was wrong. That is your problem to fix.What is Recommendation Strength?Whether a model actively recommends you or merely lists you among options.What is Post-Citation CTR?The share of AI citations that send a user to your property. Needs platform data.What is Content Utilization Rate?Whether a model drew on your content substantively or just appended a link.What is Attribution Clarity?How explicitly you are identified when your content is used.What is Citation Decay Rate?How a page’s citation performance falls off over time — its shelf life in AI systems.What makes AI visibility data decision-grade rather than directional?Query volume, intent coverage, cadence and reproducibility — the IAB sets thresholds for each.What is a query set, and which intent types should it cover?The prompts you monitor. Four intent types, and the mix changes your results.What biases distort AI visibility measurement?Two: an unbalanced query set, and a platform that just favors you. Different fixes.Why does every metric come back with a window attached?A rate without its window is not a number you can compare to anything.How do I set up the MCP server?One command for terminal agents; a connector URL for chat assistants.How do I connect Claude, ChatGPT or Claude Desktop?Add a custom connector by URL and sign in. No key to paste.How do I get an API key?Create one on the API Keys page. Nobody to ask.How do I make an install read-only?Scope the key to viewer on the folders it should see.What scopes does an OAuth connection carry?kb.read, kb.write and kb.delete. Read-only until you widen it.How do I ingest markdown?Through MCP or the raw-text endpoint, not the file uploader.Do I need the CLI, or is MCP enough?MCP covers ingest and query. Generation and publishing are CLI and API.How do I query only specific documents?Pass the content ids you want the query restricted to.How do I keep automated searches out of the gap report?Send X-Senso-Signals: off. The search still runs, costs credits and is recorded.What is the rate limit?60 requests per minute per API key.