> ## Documentation Index
> Fetch the complete documentation index at: https://prismeai-docs-next.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating a Chat Agent

> Learn how to configure and manage a Chat agent in Prisme.ai using Agent Creator, Knowledges or Builder.

<Frame>
  <img src="https://mintcdn.com/prismeai-docs-next/TwMZYLd6Xg1G75e6/images/securechat.png?fit=max&auto=format&n=TwMZYLd6Xg1G75e6&q=85&s=c3a72f94718fb47bf03895ffe1a96f8b" alt="Chat Agent Configuration" width="5760" height="3320" data-path="images/securechat.png" />
</Frame>

# Creating a Chat Agent

Chat is not a standalone product, but a **type of intelligent agent** that can be created and configured within Prisme.ai, using either **Agent Creator** or **Knowledges**, depending on the user's permissions and organizational context.

It offers a secure, AI-powered conversational experience that can be **public** to the instance or **scoped** to a specific entity, based on access rules and SSI (Security & Information Systems) configurations.

***

## Creation Options

You can create a Chat agent using one of the following methods:

<AccordionGroup>
  <Accordion title="Manual Creation via Agent Creator or Knowledges">
    Users with sufficient permissions can create Chat agents manually through the platform UI:

    * Navigate to **Agent Creator** (for general-purpose assistants)
    * Or go to **Knowledges > Agents** (for knowledge-centric assistants)
    * Set visibility (`public`, `group-limited` on Users tab, etc.)
    * Define agent prompt, tools, documents, and runtime settings
  </Accordion>

  <Accordion title="Automated via Builder">
    Use automation to define and deploy agents across environments:

    Example workflow:

    ```yaml theme={null}
    slug: create-agent-securechat
    name: Create agent Chat
    do:
      - set:
          name: agents
          value:
            - name: Chat
              category: Productivity
              public: true
              description: Your AI-powered professional assistant for daily work tasks.
              ai:
                max_tokens: 1500
                prompt: |
                  You are a virtual assistant designed to support employees in their daily professional tasks...
      - repeat:
          on: '{{agents}}'
          do:
            - Knowledge Client.Projects - Update or Create project:
                data: '{{item}}'
    ```

    This ensures traceability and multi-environment management.
  </Accordion>
</AccordionGroup>

***

## Agent Capabilities

A Chat agent typically supports:

* **Summarization** of documents and meeting notes
* **Comparison** between files or texts
* **Rephrasing** and rewriting content
* **Drafting** emails, notes, or reports
* **Web search** (if enabled) with source citations
* **Secure document handling** with contextual processing

Each response type is designed with formatting standards and structured output (e.g., tables, bullets, or paragraph summaries).

***

## Configuration Options

<AccordionGroup>
  <Accordion title="Visibility & Access Control">
    * Set `public: true` to make the agent visible to all users.
    * Or `public: false`  and then assign access by **group**, **entity**, or **workspace role** using an automation on Builder
  </Accordion>

  <Accordion title="LLM & Prompting">
    * Connect to multiple LLMs (OpenAI, Mistral, Claude, Ollama…)
    * Define a prompt depending on use case  to define tone, role, behavior
  </Accordion>
</AccordionGroup>

***

## Optional Tools & Webhooks

Agents can include tools and hooks to enhance capabilities:

<CardGroup cols={2}>
  <Card title="Tools Integration" icon="plug">
    Add tools to your Chat agent:

    * Web browsing
    * Code Interpreter
    * Image Generation
    * Custom tools
  </Card>

  <Card title="Webhooks" icon="link">
    Use webhooks for:

    * Pre-processing messages before LLM call
    * Validating user input or controlling access
    * Scanning and classifying uploaded documents
    * ...
  </Card>
</CardGroup>

***

## Monitoring Agent Activity

You can monitor the Chat agent’s activity through:

* The **Activity** tab inside the agent’s workspace (Knowledges)
* The **Builder interface**, if the agent was deployed via automation
* Optionally, activity logs can be streamed to **ElasticSearch/OpenSearch**

Tracked events include:

* Agent usage
* Chat events
* Feedback collection
* RAG/document interaction logs

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Agent Creator" icon="shop" href="/self-hosting/configuration/ai-store">
    Learn how to manage and deploy agents in the Store
  </Card>

  <Card title="Knowledges" icon="book" href="/self-hosting/configuration/ai-knowledge">
    Organize collections and document-based agents
  </Card>

  <Card title="Monitoring & Logging" icon="chart-column" href="/self-hosting/kubernetes/prometheus-grafana-operator">
    Track usage and agent activity in real-time
  </Card>

  <Card title="Create an agent" icon="wand-magic" href="/create-agents/overview">
    Learn more about agent creation
  </Card>
</CardGroup>
