Working together in projects
A project is a shared workspace with its own files, members and conversations. Everyone in it works from the same project files, and depending on the project type they can also read each other's conversations. Projects live under Projects in the sidebar. If projects aren't enabled for your organization, the entry is missing.
Choose the right project type
You pick one of two types when you create a project. The only difference is who sees the conversations. Files are available to every member either way.
| Project type | Conversations | Files |
|---|---|---|
| File sharing | Private by default. Whoever owns a conversation can make it visible to the project with Share in project. | Available to all members |
| Fully shared | Every member sees every conversation in the project. | Available to all members |
You can't change the type later. If the work is confidential, choose File sharing.
Create a project
- Open Projects in the sidebar. It lists every project you're a member of.
Enlarge figure- Select New Project.
- Enter a Project name (up to 100 characters) and, if you like, a Description (up to 1,000 characters).
- Under Project type, choose File sharing or Fully shared.
Enlarge figure- Select New Project to create it. A confirmation appears and the project opens, with you as its owner.
Next, add your colleagues on the Members tab.
Open a project
Select a project card to open it. The header shows the name and the project type, and below it are the tabs Conversations, Files and Members. Owners and admins also get Insights and Settings. The Projects link at the top left takes you back to the list.
Start a conversation in a project
- Open the Conversations tab.
- Select New Conversation. Above the message box you'll see "New conversation in project:" followed by the project name.
- Write your first message as usual.
Conversations you start inside a project use the project files for document search. The project name appears above the conversation, and selecting it takes you back to the project.
When an answer draws on project files, Sources appears below it. Expand it to see the file name and the passage the answer is based on. Content at the top right opens a side panel, and its Project files tab lists every file in the project with its status.
Enlarge figureShare a conversation in the project
In a File sharing project, a new conversation is visible only to the person who owns it. To make one of yours visible to the other members:
- On the Conversations tab, select Share in project next to the conversation. The same button also appears inside the open conversation.
Enlarge figure- The dialog "Share this chat in …?" tells you who will be able to read it. Select Share. The button now reads Shared in project.
Enlarge figureThe list also shows conversations that other members have shared. They show Shared in project too, but only the person who owns a conversation can stop sharing it. To stop sharing one of your own, select Shared in project on it again. There is no confirmation step, but the notice that follows offers Undo for a few seconds.
To share a conversation with specific people outside the project, see Sharing conversations.
Move an existing conversation into a project
If you started a conversation outside a project, you can move it into one later.
- Open the conversation. It has to be one you own.
- At the top right, open More actions and select Add to project.
- In the Add chat to a project dialog, pick the project. Each name shows its project type.
Enlarge figure- Select Save.
If you pick a Fully shared project, the dialog warns you first that every member will be able to read the conversation and all of its messages. If the conversation is already in a project, the same dialog has No project to take it out again. After any move, the conversation starts out unshared in its new project, even if it was shared in the old one.
Add files to a project
Project files are available to every member. In each project conversation, Intra AI searches them for passages that fit the question. Any member can add their own files.
- Open the Files tab.
- Drag a new file onto the upload area, or click it to browse. The file goes into your files and is attached to the project at the same time. To use a file you've already uploaded instead, select it under Attach existing file. One click attaches it right away.
- Check the status next to the file. Only files marked Ready, Partial or Truncated are used in answers. A Partial file is missing a few pages, and a Truncated one is missing everything after a certain page. If a file shows Error, the reason appears below it. When Retry is offered, select it to process the file again. Only the person who uploaded the file can retry it.
Enlarge figureA file can belong to only one project at a time. Files from synced folders stay personal and aren't offered for attaching.
Owners and admins remove a file from the project with the × button. There's no confirmation, but the notice that follows offers Undo. The file itself stays in the uploader's file list. It does, however, stop being available in the other members' project conversations.
Manage members
The Members tab lists everyone with their role. A project role applies only inside that project and has nothing to do with being an administrator in Intra AI.
| Role | What it can do in the project |
|---|---|
| Owner | Everything an admin can do, plus change roles, remove admins and delete the project. Whoever creates the project is its owner. |
| Admin | Add members, remove people with the Member role, remove files from the project, open Insights and Settings. |
| Member | Start and share conversations, attach their own files, use shared conversations and all project files. |
If you're the project owner or an admin, add someone like this:
- Under Add member, type at least two characters of the person's email address or name into the User's email field.
- The matching account appears below. Choose Member or Admin next to it.
- Select Add member.
Enlarge figureYou can only find people who already have an account in your organization. You can't invite new email addresses from here.
Only the owner can change someone's role, using the selector on that person's row, and nobody can be promoted to owner.
To remove someone from the project, select Remove member on their row and confirm "Really remove … from the project?" Their access to project files and shared conversations ends immediately. Their own project conversations leave the project and stay with them. The files they added stay in the project, though, and remain available to the other members. If those should go too, remove them on the Files tab.
The owner can't be removed. You also can't leave a project yourself. Ask the owner to remove you, or an admin if your role is Member.
Read project insights
Owners and admins can see how the project is being used on the Insights tab. At the top are the time period and the number of people who worked in the project during it. Below that are five aggregated figures: Conversation depth, Indexed documents, Ingest success rate, Stale embeddings and Never-retrieved documents. If a figure shows "The fact build is incomplete for this day." instead of a value, that day hasn't been fully computed yet. Check back later.
The figures always describe the whole project, never an individual. When too few people work in a project, Intra AI hides the working-pattern figures and says how many people it takes for them to appear. Token usage isn't shown here, because usage is recorded without a link to a project. For figures across the whole organization, see Analytics for managers.
Rename a project and adjust chunking
Owners and admins see the Settings tab.
Under General you edit the Project name and Description (optional), then select Save name and description. Every member sees the change.
Enlarge figureUnder Chunking strategy you control how project files are split into sections for document search. The options are Inherit (system default), Character, Heading-aware and Semantic, plus Chunk size (tokens) from 64 to 2,048 and Chunk overlap from 0 to 0.5. Without an override, the system setting applies, which is 512 tokens and 0.15 out of the box. Leave it on Inherit as long as answers find the right passages. When you select Save chunking settings, Intra AI automatically reprocesses the project files that answers draw on. Until that finishes, they show Processing and answers can't use them.
Enlarge figureDelete a project
Only the owner can delete a project.
- Open Settings and scroll down to Danger zone.
- Select Delete project.
- The dialog asks you to confirm and explains what happens to conversations and files. Select Delete.
Warning: The project disappears for all members right away. Conversations and files are not deleted; they stay with the people who own them. Sharing ends, though, so members lose access to the conversations and files others shared in the project.
Troubleshooting
- Projects is missing from the sidebar: projects aren't enabled for your organization. Contact your administrator.
- "Project not found": the project was deleted, or you're no longer a member. Back to Projects returns you to the list.
- "This file already belongs to another project." The file has to be removed from the other project first. An owner or admin of that project can do it.
- A file isn't used in answers: check its status on the Files tab, as described under "Add files to a project". If it shows Processing, give it a moment.
- "User not found": there's no account in your organization that matches what you typed. Check the spelling. The search starts at two characters. You also see this message when the person is already a member of the project, so check the list above.
- Add to project is missing: you don't own the conversation, it's a temporary chat, or you aren't a member of any project.
- "A run is already working in this conversation." An agent run is still open in the conversation, possibly a paused one. You can move the conversation once that run has ended.
- Share in project is missing: the project is Fully shared, where every member already sees every conversation, or the open conversation belongs to another member.