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

# AI Assistant

> Get answers synthesized from your organization's knowledge

<img src="https://mintcdn.com/omni-32b875be/WWefJ9XvxUwFd6Dd/images/omni-ai-1.png?fit=max&auto=format&n=WWefJ9XvxUwFd6Dd&q=85&s=0f6832a7c2673858a4975361e1872e78" alt="Omni AI Assistant" width="2559" height="1408" data-path="images/omni-ai-1.png" />

## How It Works

In Chat mode, Omni's AI assistant:

1. Searches across all your connected sources
2. Synthesizes information into a coherent answer
3. Provides citations so you can verify the source

## Conversations

Each chat is saved in your **Recent chats** sidebar. Click any previous conversation to continue where you left off.

## Citations

Every AI response includes links to source documents. Click these to:

* Verify the information
* Read the full context
* Access the original document in its native application

## Conversation Branching

You can edit a previous message to explore a different direction. This creates a new **branch** in the conversation, preserving the original thread while letting you take a different path. Use the navigation arrows on messages to switch between branches.

## Retry Responses

If you're not satisfied with an AI response, click the **retry button** to regenerate it. The assistant will produce a new answer using the same context.

## Agent Tools

When you ask a question, the assistant may invoke one or more tools to gather information or take action. The current toolset is:

| Tool                             | Purpose                                                                                       |
| -------------------------------- | --------------------------------------------------------------------------------------------- |
| **search\_documents**            | Search across all connected sources using filters like source, content type, author, and date |
| **read\_document**               | Fetch the full text of a document by ID                                                       |
| **read\_file** / **write\_file** | Read and write files inside a per-chat workspace                                              |
| **run\_bash**                    | Execute a bash command inside the `omni-sandbox` container                                    |
| **run\_python**                  | Execute a Python snippet inside the `omni-sandbox` container                                  |
| **send\_email**                  | Draft and send email (via the configured email provider)                                      |

Any tool call that touches the outside world (running code, sending email) is gated by an **approval prompt** in the chat UI. You can approve or reject each request before it runs.

## File Attachments

You can attach ad-hoc files directly to a chat message by clicking the attach button in the input area (or dragging a file onto the input). The assistant can read the attached file alongside indexed documents — useful for one-off questions about something that isn't connected to Omni as a source.

| Behavior                   | Details                                                                                                               |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Supported size**         | Up to 50 MB per file                                                                                                  |
| **Small text files**       | Inlined directly into the chat context so the assistant sees the full content                                         |
| **Larger or binary files** | Copied into the chat's sandbox workspace so the assistant can open them with `read_file`, `run_bash`, or `run_python` |
| **Reuse across chats**     | Uploads are not pinned to a single chat — you can reference the same upload from any message in any chat              |

<Note>
  Attachments are stored using the same content-storage backend as indexed documents (Postgres by default, or S3 if configured). They remain available until you delete them.
</Note>

## People Search

The AI assistant can look up people in your organization. Ask about someone by name or email, and the assistant will return matching profiles.

<Note>
  Omni automatically builds a basic people directory from emails and names found in indexed documents. For richer profile data (job title, department, manager, etc.), enterprise IdP connectors are available — contact [hello@getomni.co](mailto:hello@getomni.co) for details.
</Note>

## Best Practices

* **Ask follow-up questions** - The assistant remembers context within a conversation
* **Be specific** - "What's our PTO policy for employees in California?" beats "PTO policy"
* **Request formats** - Ask for bullet points, tables, or summaries as needed