Input files and knowledge files for AI agents

when you want your ai agent to work with files, you can upload your files as input files or knowledge files input files are one time files that the agent processes in a run knowledge files are reference files stored in a database that the agent repeatedly consults to find information because file processing can use a significant number of ai tokens, choosing the right file type helps keep token usage low when to use input files or knowledge files to get the best results and reduce costs, upload smaller files that the agent references once as input files, and larger files that the agent references often as knowledge input files upload your file as an input file when the agent references it once it's a small file that would use few tokens to process repeatedly you want to ensure the agent always references it or specific parts of it for security or auditability reasons you uploaded the file as a knowledge file, but the agent couldn't find the information to answer your request it's an image, and you need the agent to see the image itself, not just its description examples attachments (such as email and telegram message attachments), csv files, and images (such as brand guideline references and marketing visual assets) knowledge files upload your file as knowledge when the agent frequently references it (with or without regular updates) it's a large text file that would use many tokens to process repeatedly, or could exceed the agent's token limits examples company policies, troubleshooting guides, faqs, brand guidelines, style guides, and technical documentation next steps for more information and step by step instructions, see input files for ai agents docid\ etjxd5ckure4kbfrmadfp check input file requirements and upload files knowledge files for ai agents docid\ f4w8zw q6vkea18d0rmmi check knowledge file requirements, and upload and manage files knowledge app modules docid\ homjru nvc38w5dbxwyjh look up knowledge app module settings