> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/agent-builder-and-skills/agent-appearance-and-security.md).

# Agent appearance and security

Configure an agent’s appearance to explain its purpose and help people start a conversation. Use security settings to control who can open the chat.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FmgOgIDvhtItru9Oxl3Qv%2FG015.mp4?alt=media&token=a9a92c48-3b31-45fc-969d-c9eebbe0c7be>" %}

## Before you start

Open the agent from **Projects** to its **Agent Builder** configuration panel. If you have a workflow rather than a simplified agent, use [Publish a Chat Assistant](https://docs.stackai.com/guides-and-quickstarts/interfaces-and-end-user-experiences/publish-a-chat-assistant.md) for its interface controls. For an agent that has not yet been created, start with [Build your first AI agent](https://docs.stackai.com/guides-and-quickstarts/agent-builder-and-skills/build-your-first-ai-agent.md).

## Understand protected access

A protected chat asks users to authenticate before they can start a conversation.

![Protected chat authentication gate](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/H53WP8xXPaPnFLb78Voj/assets/g015-g015-01-password-gate.png)

## Set the name and description

Enter a **Name** and **Description** that explain the agent’s purpose. Review them in the preview.

![Agent name and description in preview](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/YhO5x5v94Hw0RYRJQvHV/assets/g015-g015-02-welcome-identity.png)

## Set the message prompt

Use **Input Placeholder** to give users a short hint about what to enter.

![Input Placeholder configuration](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/LDGW8ragw4u9SBfosvk8/assets/g015-g015-03-input-placeholder.png)

## Configure access and follow-ups

Scroll to **Security** in the Agent Builder configuration panel. Configure **Password Protect** or **Login with SSO** as appropriate for the people who should use the agent. SSO means signing in through your organization’s identity provider; it requires your organization’s setup. Review [Interface authentication and access](https://docs.stackai.com/guides-and-quickstarts/interfaces-and-end-user-experiences/interface-authentication-and-access.md) for access choices and prerequisites.

In **Advanced Settings**, use **Enable followups** to control suggested follow-up questions. Draft changes save automatically; check the save status before publishing.

![Agent security and follow-up settings](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/o2IpkOIuXBZvhrN7OdX5/assets/g015-g015-04-settings.png)

## Publish and share the agent

After checking **Draft Preview** and security, select **Publish Agent**. When publication succeeds, choose **Go to Published Agent** to open the user-facing chat. Use **Share** to obtain its link after publication. If publication is unavailable or your organization requires approval, use [Deployments and approval requirements](https://docs.stackai.com/guides-and-quickstarts/releases-and-environments/deployments-and-approval-requirements.md) and ask an authorized reviewer to complete the required release.

A saved draft and a published agent are separate states. Check the published chat after each release before sending its link to users.

## Review the chat experience

Open the interface and select a conversation starter. Check the welcome content and follow-up suggestions.

![Conversation starter and chat response](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/0zA8PjkNMlCeUTDONJWU/assets/g015-g015-05-starter-result.png)

Open the interface in a session that has not authenticated. It should ask for the configured sign-in method before allowing a conversation.

![Authentication requirement in a new session](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/yGtKOnDJZL0Ss67PoS3h/assets/g015-g015-06-persisted-gate.png)

## Important behavior

Publish saved interface changes when you want them to appear in the deployed chat.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/guides-and-quickstarts/agent-builder-and-skills/agent-appearance-and-security.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
