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

# Getting Started with Coworker

> Chat with an AI assistant that connects to all your tools, agents, and knowledge bases

Coworker is your AI-powered assistant inside Pinkfish. Ask questions, delegate tasks to specialized agents, pull context from your knowledge bases, and interact with connected tools — all within a single chat interface. Coworker automatically has access to all the tools and integrations configured in your workspace.

## Key Features

<CardGroup cols={2}>
  <Card title="Agent Mentions" icon="at">
    Use `@` to mention and delegate tasks to any agent in your organization directly from the chat.
  </Card>

  <Card title="Knowledge Base" icon="brain">
    Select a knowledge base collection to give Coworker context from your documents and data.
  </Card>

  <Card title="Tool Access" icon="wrench">
    Coworker discovers and uses all connected tools and integrations automatically.
  </Card>

  <Card title="Conversation History" icon="clock-rotate-left">
    Search, filter, and revisit past conversations organized by time and agent.
  </Card>
</CardGroup>

## Getting Started

Navigate to **Coworker** in the sidebar. You'll see a welcome screen with:

* A chat input where you can type your message or use `@` to mention an agent
* **Suggestion cards** showing available agents, workflows, and apps you can interact with
* Tabs to filter suggestions by **Favorites**, **All**, or **Agents**

<img src="https://mintcdn.com/pinkfishai/crvxBT6SXMmd0H0W/images/coworker/coworker-welcome.png?fit=max&auto=format&n=crvxBT6SXMmd0H0W&q=85&s=751c847e5605083e3f0b69a09673c155" alt="Coworker welcome screen with chat input, suggestion cards, and sidebar" width="3024" height="1620" data-path="images/coworker/coworker-welcome.png" />

Type your message and press **Enter** or click the send button to start a conversation. Coworker creates a new chat automatically and streams its response in real time.

## Chatting with Coworker

Once in a conversation, you can send messages back and forth with Coworker. The chat interface shows:

* **Your messages** on the right side
* **Assistant responses** on the left, with the responding agent name and a "Thought for Xs" indicator showing processing time
* An **Artifacts** button in the header for any generated files or outputs

<img src="https://mintcdn.com/pinkfishai/crvxBT6SXMmd0H0W/images/coworker/coworker-chat.png?fit=max&auto=format&n=crvxBT6SXMmd0H0W&q=85&s=89a6f5676d4adc17e5c1a2bc52681626" alt="Active chat showing a conversation with Coworker" width="3024" height="1620" data-path="images/coworker/coworker-chat.png" />

### Mentioning agents

Type `@` in the chat input or click the mention button to bring up a list of available agents. Select an agent to delegate a specific task to it within the same conversation.

<img src="https://mintcdn.com/pinkfishai/crvxBT6SXMmd0H0W/images/coworker/coworker-mention.png?fit=max&auto=format&n=crvxBT6SXMmd0H0W&q=85&s=8d5752f4647d368a6b91aebb5aeb97ba" alt="Agent mention selector showing available agents" width="3024" height="1620" data-path="images/coworker/coworker-mention.png" />

Coworker routes your message to the mentioned agent and returns its response inline. This lets you orchestrate work across multiple specialized agents without leaving the chat.

### Attaching files

Click the file attachment button to upload files directly into the conversation. Supported formats include images (JPG, PNG, WEBP), documents (PDF, CSV, TXT, MD, JSON, HTML, XLSX, DOCX, PPTX), and video (MP4, MOV).

### Using a knowledge base

Click the knowledge base icon in the chat input to select a collection. This gives Coworker access to the documents and data in that collection, so it can reference them when answering your questions.

<img src="https://mintcdn.com/pinkfishai/crvxBT6SXMmd0H0W/images/coworker/coworker-knowledge-base.png?fit=max&auto=format&n=crvxBT6SXMmd0H0W&q=85&s=c27f02ffcd0b7c6f6d4cf07a880684ab" alt="Knowledge base selector showing available collections" width="3024" height="1620" data-path="images/coworker/coworker-knowledge-base.png" />

Once selected, knowledge base results appear as tiles in the chat alongside Coworker's response. For more on creating and managing collections, see [Datastore](/resources/database).

## Managing Conversations

### Conversation sidebar

The left sidebar lists all your conversations, grouped by **Today** and older chats. From the sidebar you can:

* Click **New Chat** to start a fresh conversation
* Click any chat to resume it
* Right-click or use the menu on a chat to **rename** or **delete** it
* See unread message indicators and **New** badges on shared chats

### Chat history

Click **Search Chats** in the sidebar to open the full chat history view. Here you can:

* Search conversations by title
* Filter by agent using the dropdown
* See when each conversation was created with relative timestamps

<img src="https://mintcdn.com/pinkfishai/crvxBT6SXMmd0H0W/images/coworker/coworker-chat-history.png?fit=max&auto=format&n=crvxBT6SXMmd0H0W&q=85&s=f62d4995257bbeddd859e64b811c04fe" alt="Chat history page with search and agent filter" width="3024" height="1620" data-path="images/coworker/coworker-chat-history.png" />

## Suggestions and Discovery

The welcome screen displays suggestion cards for items in your workspace:

* **Agents** — click to mention the agent in your next message
* **Workflows** — click to view the workflow details
* **Apps** — click to open the app

Use the search bar to filter suggestions by name, or click the star icon on any card to add it to your **Favorites** tab for quick access.

## Notes

* Knowledge base collection selection is locked after the first message in a chat. Start a new chat to switch collections.
* Coworker can be connected to Slack and Microsoft Teams workspaces for use outside the Pinkfish app. See the [Slack Channel](/channels/slack) guide for details.
* Conversations can be shared with other organization members. Shared chats show a badge in the sidebar.
