Documentation

In this introduction, you’ll learn what Caddey is, how it works, and the key concepts that form the foundation of the platform.

What is Caddey?

Caddey is a platform that transforms app features into executable tools for your AI agents. Whether you're using ChatGPT, Co-Pilot, or a custom AI agent, Caddey enables seamless integration and empowers your AI to take real actions safely—like scheduling meetings, automating workflows, or fetching data from your favorite apps.

With Caddey, you can:

• Connect your apps: Use OpenAPI specifications or the Caddey marketplace to add app features in just a few clicks.
• Create tools: Automatically generate tools (e.g., "Send Email," "Fetch Data") from connected apps.
• Build toolboxes: Group tools into reusable sets for specific workflows.
• Publish apps: Share your own app integrations on the marketplace so other organizations can discover and connect them.
• Connect AI agents: Allow your AI agents to search, discover, and execute tools securely through OAuth integration.

Key concepts

Here are the core concepts you’ll encounter while using Caddey:

• Apps: External services (like Google Calendar, SharePoint, or Zendesk) that you connect to Caddey—either directly via an OpenAPI spec or through the Marketplace.
• Marketplace: A public catalog where integrations are published and shared. You can browse for ready-made app connectors or publish your own for others to use.
• Tools: Individual operations (e.g., “Send Email,” “Create Task”) extracted from apps for use by your AI agents.
• Toolboxes: Groups of tools combined into workflows tailored to your needs (e.g., a "Customer Support" toolbox).
• OAuth Clients: Secure connections that represent your AI agents and control their access to tools and toolboxes.
• AI agents: Models like ChatGPT or Co-Pilot that execute tools through Caddey via OAuth authentication.
• Security: Caddey ensures your app credentials remain secure without exposing them to AI agents, and tools are executed safely with granular access controls.

How Caddey works

Caddey simplifies the process of turning app features into actionable tools for your AI agents. Here’s a high-level overview:

1. Connect or discover an app: Upload an OpenAPI spec or browse the marketplace to find integrations published by the community.
2. Generate tools: Tools are automatically extracted and configured for use.
3. Build toolboxes: Combine tools from multiple apps into reusable groups.
4. Create OAuth clients: Set up secure connections for your AI agents with appropriate access to toolboxes.
5. Integrate AI agents: Use OAuth authentication to enable your AI agents to discover and execute tools securely.