Lagniappe can use Google Vertex AI for optional generation, extraction, and summarization features. AI runs only when a user invokes an AI action.
The goal is not to sprinkle AI everywhere, but to use it where the app already knows the relevant form schema, document, file, page, task, and permission context.
What AI Can Do
- Generate draft form schemas from descriptions.
- Autofill page or task forms from existing context, files, images, or user instructions.
- Generate editable document text.
- Generate page or document images.
- Summarize uploaded files for review or search.
- Create draft categories, projects, model tasks, pages, and schedules.
- Look up permitted workspace records and application help while working on a request.
- Answer questions using only the records, files, and tasks the current user can access.
- Suggest workspace-native actions, such as adding pages, tasks, files, forms, or projects in the right place.
Plans & Reports
Open Create a Plan on Home with a question, a request, files, or a combination of them. For example, you might ask what repairs a property needs, or attach inspection notes and ask for follow-up tasks. One saved plan can contain both an answer and proposed workspace changes.
Read the answer and review proposed changes before applying them. Use Revise Plan to correct the proposal, then Execute Proposal when it is ready. A question that needs no changes finishes with its answer. Files can stay with the plan as supporting evidence; say when they should not be filed onto a page or task.
On the homepage, combine the Active, Executed, and Answers filters to choose which saved reports to show. Active includes proposals that are ready, still processing, or need attention. Executed contains completed proposals. Answers contains saved answers without executable changes. Each count includes reports hidden by the current filters.
Select Executed alone to delete all displayed executed proposals after one confirmation. This removes their reports, undo history, and report-only uploads. Created pages, tasks, and other workspace changes remain. Your browser remembers your filter choices.
Per-User AI Access
An Administrator chooses a separate AI level for each ordinary user; only the primary Owner edits another Administrator’s account. This level controls features that call Lagniappe’s configured model provider: None disables those calls, Ask allows workspace questions with supporting files and saved answers, and Create also enables proposals, generation, autofill, and summarization. Create includes Ask.
This setting is independent from user groups and permissions, so a user can have broad workspace permissions without AI access, or AI access that still operates only within a narrow set of permitted records.
External-agent API plans use the user’s own AI client and tokens, so they are not controlled by this provider entitlement. Working with an already saved report is also provider-free. API plans and report execution still use the signed-in user’s normal workspace permissions.
AI Email
When AI email is enabled, registered users can send questions, requests, and attachments to a single AI address from the email registered on their Lagniappe account. It uses the same planner as Create a Plan on Home. Sending files without instructions asks the planner to organize them.
An acceptance receipt confirms intake. Open the saved plan to read the answer and review any proposed changes. Results follow your ordinary notification-email preference. Replies with new instructions above the email’s reply marker start a new request.
Use an external AI agent: MCP or skill
An installation can disable AI entirely, or allow built-in AI while disabling external agents. External access covers both MCP and the API/skill.
MCP: add the installation’s MCP server URL to a compatible agent, then sign in to Lagniappe and allow the connection. The server exposes workspace tools directly. No local Lagniappe package is required.
Skill: for an agent that can make HTTP requests, create an API key under My Page / User Settings / External agent API. Ask the agent to fetch the skill below using that key and install it for itself. Keep the key in the agent’s secret settings; do not paste it into shared prompts or files.
Ask the installation Owner whether
external access is enabled and for its MCP server address. The skill URL is
https://YOUR-LAGNIAPPE-SITE/api/v1/client-skill.md; replace the
example host with the installation’s website address.
Connect ChatGPT: app or web plugin
You can add this installation as a custom plugin in the ChatGPT desktop app or on the web. No Codex CLI or Lagniappe API key is needed.
- In ChatGPT, open Settings / Security and login and enable Developer mode. Availability depends on your ChatGPT account and workspace policy.
- Open Plugins and select the +
button to add a connection. Enter
lagniappe-remoteas the name and a description such as “Connect to my Lagniappe workspace.” - Under Connection, enter the MCP server URL:
https://MCP-ENDPOINT/mcp. Obtain the connection name and full MCP URL from the installation Owner and replace these examples. Choose OAuth if asked for an authentication method, then create the connection. - Follow the sign-in prompt, sign in to your invited Lagniappe account, check the account shown, and choose Allow. ChatGPT may ask you to connect during setup or the first use.
- Start a new chat, select the plugin from the tools menu, and ask ChatGPT which Lagniappe account it is using. Then ask it to find a page you know you can access.
If ChatGPT asks you to reconnect later, use its Reconnect action and authorize again. Manage or remove the plugin from Plugins. To revoke its Lagniappe access, open Settings / Manage AI connections in Lagniappe.
See OpenAI’s connection instructions and plugin guide for current ChatGPT controls.
Connect Codex CLI
With Codex CLI installed, run this command in a terminal. No Lagniappe API key or local Lagniappe package is needed.
Ask the installation Owner to confirm Codex access is enabled and
replace https://MCP-ENDPOINT/mcp with its MCP
server URL. You need an invited, non-public Lagniappe account.
codex mcp add lagniappe-remote --url https://MCP-ENDPOINT/mcp --oauth-client-id lagniappe-codex
Follow the sign-in link printed by Codex. Sign in to Lagniappe, check the account shown on the consent page, then choose Allow.
If sign-in does not start, or you need to reconnect later, run:
codex mcp login lagniappe-remote
When the terminal confirms login, you can close the localhost completion tab. Restart any existing Codex sessions to load the connection, then ask Codex to check which Lagniappe account it is using.
Codex in the ChatGPT desktop app shares this local MCP configuration. Restart it after setup. ChatGPT web uses the plugin connection above.
To switch accounts, sign in to the intended account in Lagniappe first, then run the login command again and restart Codex. To revoke a connection, open Settings / Manage AI connections in Lagniappe.
Both use the user’s normal workspace permissions and the external agent’s model provider. Both can answer questions and prepare plans; workspace changes still require review in Lagniappe. Either can be used on its own. If both are installed, tell the agent which one to use to avoid duplicate work.
Permission-Scoped Context
AI tools use the same permission boundaries as the rest of Lagniappe. When a user asks a question or starts an AI workflow, the app assembles context through server-side permission checks instead of handing the AI an owner-level view of the workspace.
For example, if someone is invited only to an old house category, they can ask about electricians, repairs, files, or tasks in that category. Other houses, other categories, and records they cannot view are left out of search results and AI tool responses.
Privacy Model
Built-in AI requests go through your own Google Cloud project’s Vertex AI configuration. That is a meaningfully different posture from pasting private data into a consumer chatbot account, though it is still a cloud AI service: prompts, files, and generated output are sent to Google for processing under your cloud terms and settings.
The training boundary is the important difference. Consumer AI products may use conversations to improve or train their services depending on the product, plan, and account settings. Google Cloud’s managed Gemini model terms say Google will not use customer data to train or fine-tune AI/ML models without prior permission or instruction. That is stronger than relying on a consumer account toggle, but it is not the same as local-only processing.
If zero data retention matters for your installation, choose those settings intentionally. Google’s guidance calls out several retention paths to review, including abuse-monitoring exceptions, request-response logging, cached data, and grounding features that may keep limited logs: Gemini Enterprise Agent Platform zero data retention. Lagniappe setup can help disable Vertex AI caching, but that is one control rather than a blanket guarantee for every AI feature or future provider setting.
Cost
AI usage is pay-per-use through your cloud project. Text operations are usually small. Image generation and large file analysis cost more, and provider pricing can shift over time.
Budget alerts in Google Cloud are an easy safety net. If you turn on search grounding, file processing, image generation, or run large planning requests, it is worth glancing at usage a little more often.
Change models in Admin / Site Settings / AI Models. The installer can change AI and external-agent access with:
./setup.sh ai
Good to Know
AI is a helpful collaborator rather than an oracle. A few things to keep in mind when reviewing its output:
- Generated schemas can look reasonable and still need a tweak or two.
- Autofill may skip a value, or fill one in that you would rather leave blank.
- File summaries occasionally miss a detail that matters.
- Search-grounded answers can lean on the web rather than your own policy or records.
- Model names, pricing, and retention settings live with the provider and can change.