Team Files

Team Files lets you upload documents to your team's storage. These files become searchable knowledge that AI agents can reference when running workflows.

What are Team Files?

Team Files are documents uploaded to your team's knowledge base. When you upload a file:

  • It is stored securely in your team's storage
  • AI automatically generates a summary and keywords for search
  • Agents can find and reference the file content during workflow execution
  • Use Team Files for company policies, style guides, product documentation, reference materials, or any text content your agents need to access.

    Uploading Files

    How to Upload

  • Navigate to your team's Files page
  • Click Upload File
  • Select a file from your computer
  • Wait for processing to complete
  • Supported File Types

    Team Files currently supports text-based files:

    ExtensionType
    .mdMarkdown
    .txtPlain text

    File Size Limit

    Maximum file size: 1 MB

    Processing

    After upload, files are processed automatically:

  • Short files (under 500 words): The full content is indexed as-is
  • Longer files: AI generates a summary (up to 300 words) that captures key information, rules, and requirements
  • Each file receives a unique slug (e.g., #blog-rules) that agents can use to reference it directly.

    Managing Files

    Viewing Files

    The Files page displays all uploaded files with:

  • File name and type
  • File size
  • Processing status
  • Upload date
  • Whether the file is pinned to context
  • Click on a file to view its metadata, AI-generated summary, and download the original content.

    File Status

    Files can have the following status:

    StatusDescription
    ReadyFile is processed and available for search
    ProcessingFile is being summarized
    FailedSummarization failed (you can retry)

    If summarization fails, use the Regenerate Summary action to retry.

    Searching Files

    Use the search bar on the Files page to find files by:

  • File name
  • Keywords extracted from the content
  • File slug (e.g., #blog-rules)
  • Deleting Files

  • Click on the file you want to delete
  • Select Delete
  • Confirm the deletion
  • Deleted files are permanently removed and cannot be recovered.

    Editing Summaries

    You can manually edit a file's AI-generated summary if needed:

  • Open the file details
  • Edit the summary text
  • Save changes
  • This is useful when the AI summary misses important details or you want to emphasize specific information.

    Using Files with AI

    How Agents Access Files

    When an agent runs, it can search your team's knowledge base to find relevant files. The agent sees:

  • The file's summary (or full content for short files)
  • Keywords for context
  • The file slug for reference
  • Agents use this information to inform their responses and actions.

    Always in Context

    You can pin important files to be always in context. Pinned files are automatically included in every agent run, without requiring a search.

    Use this for:

  • Critical company policies
  • Brand guidelines
  • Frequently referenced standards
  • Limits:
  • Maximum 5 files can be pinned
  • Combined token budget of approximately 3,000 tokens
  • To pin a file:

  • Open the file details
  • Enable Always in Context
  • Save changes
  • Files vs Connections

    Use Files WhenUse Connections When
    Content is static or rarely changesData changes frequently
    You have documents, policies, or guidesYou need real-time data from external systems
    The information fits in a text fileYou need to interact with APIs (read/write)
    Examples:
  • Style guide with writing rules: File
  • Current project tasks from Asana: Connection
  • Company vacation policy: File
  • Customer data from CRM: Connection