Analyzes the content of attachments (images, videos, audio, PDFs, documents) from posts on the padlet.
- Purpose: Retrieve and analyze post attachment content so you can describe, summarize, or answer questions about what's in the attachments.
- What this tool returns: { success: true, analysis: { posts: [{ post_id, attachments: [{ description }] }] } } with a structured analysis grouped by post_id; { success: true, message: "No valid attachments to analyze" } when none of the posts has an attachment it can read; otherwise { success: false, message: "..." }.
Guidance for use:
- Use this tool when the user asks about the content of images, videos, audio, documents, or other attachments in posts.
- Identify which posts have attachments before calling. If an EXPLICIT list of post_ids to analyze has been provided to you in the conversation, use those directly. Otherwise, call `get_padlet_content` first to discover them.
- A post has an attachment if its "attachment" field contains a URL (not empty, not "poll"). Check BOTH the "attachment" field and "attachment_props" — some posts have a URL in "attachment" but empty "attachment_props".
- Pass the post_ids of posts whose attachments you want to analyze. The tool will retrieve the attachment URLs automatically.
- Pass at most 50 post IDs per call. If there are more, prioritize the most relevant posts.
- Only analyzes attachments the current user has permission to view.
- Do not use this tool if the user is not asking about attachment content.
- Results are cached: previously analyzed attachments return cached descriptions without re-analyzing.
- IMPORTANT: Only pass the `query` parameter when the user has a specific, targeted question about the attachment content (e.g. "What formula is on slide 3?", "What color is the logo?"). For general requests like "describe the attachments", "what's in the images", or "summarize the content", do NOT pass a `query` — omit it entirely so the tool returns a comprehensive generic description.
