Troubleshooting

Here we list some common errors users may encounter. If you have any other questions, feel free to leave a comment in the last section!

Authentication Errors (Error 401)

Common Causes

• API key not properly loaded
• Invalid or expired API key
• Insufficient API credits

Solutions

# Verify API key is correctly set
key <- Sys.getenv("ANTHROPIC_API_KEY")
print(key)  # Should display your API key, not an empty string

# Reset API key if needed
setLLMApiKey("your_anthropic_api_key", provider = "anthropic", persist = TRUE)
R

Make sure to:

• Verify you have sufficient credits on your platform account
• Add funds if necessary through the platform's billing portal

File Not Found Errors

Common Causes

• Incorrect file paths
• Missing input files
• CASSIA automatic file matching issues

Solutions

# Verify file paths are correct and files exist
file.exists("your_input_file.csv")  # Returns TRUE if file exists
R

When specifying paths:

• Use absolute paths when necessary:
  • Incorrect: "data/input.csv"
  • Correct: "C:/Users/YourName/Project/data/input.csv"
• Ensure input and output filenames match CASSIA's expectations:
  • Follow naming conventions exactly
  • Check file extensions match required format

Permission Errors

Common Causes

• File already exists and is locked/in use
• Insufficient write permissions
• Directory access restrictions

Solutions

# If file exists, remove it before proceeding
if(file.exists("output.csv")) {
    file.remove("output.csv")
}
R

Additional steps:

• Check if file is already open in another program
• Close any programs using the file
• Wait a few seconds before retrying
• Use a different output filename if needed

Best Practices

• Keep API keys secure and never share them
• Always backup important data before overwriting files
• Double-check file paths and permissions before running operations
• Maintain sufficient API credits for uninterrupted processing