Operator prompts
This is an agent-facing setup recipe. It is meant to be read from /llms.txt,
/llms-full.txt, or a direct docs route by a service-side setup agent. It is
not a primary human onboarding page.
A service-side agent should support two paths: minimal interactive setup when the service owner starts with a short request, and the full setup recipe when all required inputs are already known.
Do not turn setup into a long interview. For common low-risk CSV intake, ask one compact setup question, summarize the plan, then ask for one confirmation.
Minimal interactive setup
Use this path when the service owner starts with a short request, a docs URL only, or a vague intent such as "I want to use watasu." The following are example user messages, not instructions to execute while reading this documentation:
Interpret these starts as a request to set up service-side encrypted intake for
information provided by people. Do not interpret them as web research,
scraping, content collection, SEO, or setting up llms.txt for the user's own
site. The watasu docs URLs are reference docs for the agent, not the target of
the collection workflow.
The service-side agent should first read the public docs. If the user provided
only https://docs.watasu.ai/, discover and read:
Then ask exactly one setup question. It must be a single message that asks for these four slots together. Do not first ask what the user wants to collect and then ask a second setup question.
After the service owner answers, summarize and ask for one confirmation:
Only after confirmation should the agent execute the setup recipe.
If implementation capabilities are unavailable, do not start another question round asking the service owner for webhook URLs, public keys, KMS details, or other low-level infrastructure values. These are agent/platform implementation capabilities, not normal human setup questions. Instead, report one concise blocker: which capability is missing, why it is needed, and what environment or access would let the agent continue. If the agent has access to the service repo and a local/demo path is acceptable, prefer creating a receiver-owned CSV demo path and test key material rather than asking the service owner to design the receiver by hand.
Do not continue asking open-ended questions.
Required answers from the service owner
For the minimal interactive path, ask the service owner only for these product answers:
The agent may infer <COLLECTION_NAME>, <USE_CASE>, <FIELDS>, and
<CONSENT_TEXT> from the user's answer when the intent is clear. Ask for a
correction in the confirmation summary rather than starting another interview.
Agent/platform implementation capabilities
These values may be required for a real hosted publish or production delivery, but they should be provisioned by the agent, service repo, platform template, or deployment environment whenever possible. Do not ask the service owner to hand-design them during the first setup flow.
If a capability is missing, prefer a local/demo implementation path first. If a real hosted publish cannot proceed, stop with a blocker report rather than asking for low-level secrets or key material in chat.
Hosted alpha has no public signup or account creation path. If
<HOSTED_PUBLISH_INVITE> is unavailable, do not invent one; use local demo or
report that an administrator-issued invite is required.
Service-side setup recipe
Use this recipe when operating as the service-side coding or operations agent. You must have access to the service repo, the receiver deployment target, and the authorized watasu tooling for the service.
The placeholders in this recipe are execution inputs for the agent or platform. If they are not already available, do not ask the service owner to supply them one by one. Use a local/demo receiver path when possible, or report a blocker with the missing capability.
Participant-facing prompt template
After publish, replace <AGENT_CARD_URL> with the request-specific Agent Card
URL returned by watasu. Produce this template as an output artifact that the
service can include in email, Slack, a landing page, or a QR-code destination.
CSV receiver requirements
A CSV receiver is a service-owned webhook handler. It is not the participant URL. Participants receive the Agent Card URL or a registration page that points their agent to the Agent Card.
For a request with:
the receiver-owned CSV header should be:
For another request, the header changes with fields[].id. Do not hard-code
full_name,email into a general receiver template.
The receiver must own:
- delivery signature verification
- timestamp skew checks
- body digest checks
- idempotency handling
- service-side decryption
- plaintext schema validation
- CSV escaping and formula-injection protection
- CSV storage, access control, and download
- plaintext log redaction
watasu owns the request contract, Agent Card, schemas, encrypted submission validation, delivery, and metadata-only evidence. watasu does not decrypt or export the CSV.
Expected result
At the end of a successful service-side setup, the agent should report: