Make your assistant easy to find.

Add chat for visitors and a direct connection for their agents. Follow the steps in Agent → Installation, or give its setup skill to your coding agent.

Let your coding agent install it

In Installation, choose Set up with your coding agent. Copy the setup prompt or download SKILL.md. It contains your workspace’s exact snippet, public connection instructions, and checks for the published site.

Install the skill from your website project

Copy the install command shown in your workspace. The skills installer downloads the hosted skill and lets you choose your coding agent. Then give it the setup prompt.

The skill handles the website edits. Domain verification stays in your Ambipath workspace, where you can copy the DNS record for your domain provider.

1. Save and verify your website

Open your workspace, choose Agent → Installation, and save the website where the assistant will appear. Follow the domain verification instructions, then allow that website for your assistant. You can also keep a workspace private while you prepare it.

2. Publish the website snippet

Copy the snippet from Installation into your website template. It includes one HoverChat loader and links to the assistant’s manifest and public connection instructions. Use the generated values for your workspace.

Already installed the HoverChat loader? Keep that script once and add the new links. Merge the generated connection block into your site’s llms.txt or agents.md, and update any developer or authentication guide. Then publish the website.

The downloadable human guide and setup skill include these steps together.

3. Check the published installation

Return to Installation and choose Check installation. It checks your public website without sending a chat message or using inference credits.

If one needs attention, follow its result, republish your website, and check again. A saved result describes the page at the time it was checked.

4. Help agents that read your site

Installation gives you Markdown for /llms.txt or /agents.md and, under advanced options, an entry for an existing /.well-known/ard.json directory. Include the guest connection instructions so an agent can ask a question even without a PAP client. Keep your other entries when adding it.

Your canonical manifest ends in /.well-known/poppy.json on the Ambipath assistant host. Link to that address. Do not copy its contents onto another domain, or rename it to agent.json.

If your host supports real HTTP redirects, it can redirect your website’s /.well-known/poppy.json to the canonical manifest. Static hosts such as GitHub Pages can instead publish the HTML link and reading-guide pointers.

5. Try the agent your customers use

Ask it to find your assistant, report the manifest URL, and describe the available connection. Then ask it to make a test conversation if it supports that connection.

Public questions can use the guest HTTP API without a browser or customer sign-in. Clients that support PAP can instead sign each request with their own published identity. Installation includes both connection paths.

Ask one question, then read its result. If the reply is still being prepared, keep reading the same conversation. The connection examples handle delayed replies and interrupted requests.

Choose a connection for your agent

HTTP: open the guest API contract, create a conversation, and send the question with its session token. Keep the operation ID when retrying an interrupted request.

Standard MCP: use the Ambipath guest connector, which provides ask, read, wait, and resume tools over the same API.

PAP: use the manifest and a client that signs Poppy-Session requests. The reference client includes identity setup, delegation, and request signing. The hosted PAP MCP endpoint uses the same proof.

Open the public API contract. Get your workspace’s addresses and examples under Installation → Connect other agents.

Keep the conversation useful

Visitors can ask immediately. The conversation menu lets them add context, share contact details, or request follow-up when they want to. Your team sees those details beside the conversation, with their source clearly labeled.

Optional customer accounts

Enable verified email or configure your store’s customer-account connection in Agent settings. Customers choose whether to connect. Private information is available only within the permission they grant.

Removing permission stops account access. Public questions continue through a new guest conversation.

For developers

The public manifest advertises the assistant’s endpoints and authorization server. Public PAP questions need a signed request proof; account-specific access additionally needs customer authorization.