Cloud

What it does

This Cloud skill provides persistent storage for chat threads, messages, and files within an AI agent environment. It allows seamless access and management of cloud storage services directly through the assistant interface. The skill supports flexible authentication methods including JWT tokens (recommended), API keys, and anonymous access. It integrates with the assistant-ui runtime via specific classes and transports.

When to use it

• To store and retrieve chat history across sessions.
• For applications requiring secure file uploads and sharing using presigned URLs.
• When building public applications that need simple, anonymous access to cloud storage.
• To manage thread operations like listing, creation, updating, and deletion.

Key capabilities

• Thread Operations: List, create, update, and delete chat threads.
• Message Retrieval: Retrieve messages associated with a thread.
• Authentication Modes: Supports JWT tokens (recommended), API keys for server-side use, and anonymous access.
• Presigned URLs: Generates presigned URLs for secure file uploads with public URL access.
• Integration: Integrates directly with the AssistantCloud class and AssistantChatTransport within the assistant-ui runtime.

Example prompts

• "List all my chat threads."
• "Create a new thread called 'Project Brainstorm'."
• "Upload this file to the cloud using a secure link."
• "Retrieve messages from the 'Project Brainstorm' thread."

Tips & gotchas

• Authentication: JWT tokens are the recommended authentication method for enhanced security.
• API Updates: Always consult assistant-ui.com/llms.txt for the latest API documentation and changes.
• Base URL Configuration: Ensure the baseUrl is correctly configured with your cloud storage endpoint (e.g., using environment variables like NEXT_PUBLIC_ASSISTANT_BASE_URL).