Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.upsonic.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tasks can include document attachments for processing. The framework automatically handles document loading and provides them to the model for analysis.

​
Single Document Attachment

from upsonic import Agent, Task

agent = Agent(model="anthropic/claude-sonnet-4-5")

# Task with single document
task = Task(
    description="Summarize the key points from the attached document",
    context=["report.pdf"]
)

agent.print_do(task)

​
Multiple Document Attachments

from upsonic import Agent, Task

agent = Agent(model="anthropic/claude-sonnet-4-5")

# Task with multiple documents
task = Task(
    description="Compare the two attached documents and identify key differences",
    context=["document1.pdf", "document2.pdf"]
)

agent.print_do(task)

​
Supported Document Formats

The framework supports various document formats including:
  • PDF (.pdf)
  • Word Documents (.docx)
  • Text Files (.txt)
  • Markdown (.md)
  • JSON (.json)
  • XML (.xml)
  • CSV (.csv)
  • HTML (.html)
  • CSS (.css)
  • Python (.py)
  • JavaScript (.js)
from upsonic import Agent, Task

agent = Agent(model="anthropic/claude-sonnet-4-5")

# Example with different document formats
task = Task(
    description="Analyze all the attached documents",
    context=["report.pdf", "data.csv", "notes.md"]
)

agent.print_do(task)

​
Folder Context

The framework also supports passing folder paths to automatically include all files within a directory: 
from upsonic import Agent, Task

agent = Agent(model="anthropic/claude-sonnet-4-5")

# Task with folder context - includes all files in the folder recursively
task = Task(
    description="Analyze all documents in the attached folder",
    context=["/path/to/documents/folder"]
)

agent.print_do(task)

​
Best Practices

  • File Paths: Use absolute or relative paths that are accessible to your application
  • Document Size: Consider document file sizes for performance optimization
  • Format Selection: Choose appropriate formats based on your analysis needs
  • Error Handling: Handle cases where document files might not be accessible
  • Context Integration: Combine documents with relevant text context for better analysis
  • Tool Integration: Use specialized document analysis tools when available
  • Folder Organization: Organize related documents in folders for easier context management