Key Concepts
Before diving deeper, it’s helpful to understand the key concepts that make up the Corral AI platform.
Workspaces
A workspace is the top-level organizational unit in Corral AI. Think of it as a container for your projects, agents, and team permissions.
- Each Azure deployment can have multiple workspaces
- Workspaces provide isolation between different teams or use cases
- Permissions are managed at the workspace level
Projects
Projects are collections of related agents and configurations within a workspace.
Workspace: Acme Corp├── Project: Customer Support│ ├── Agent: Support Bot│ └── Agent: FAQ Assistant├── Project: Internal Tools│ └── Agent: HR Helper
Agents
Agents are the AI assistants that interact with your users. Each agent has:
- System Prompt: Instructions that define the agent’s personality and capabilities
- Tools: External capabilities the agent can use (search, APIs, etc.)
- Knowledge: Documents and data the agent can reference
- Channels: Where the agent is deployed (Teams, web, API)
Tools
Tools extend what agents can do beyond conversation:
| Tool Type | Description |
|---|---|
| Search | Query internal knowledge bases |
| API | Call external services |
| Code | Execute code snippets |
| Canvas | Render rich content |
Channels
Channels are the interfaces through which users interact with agents:
Microsoft Teams
Deep integration with Microsoft 365. Agents appear as bots in chats and channels.
Web Chat Widget
Embeddable widget for websites. Customize appearance to match your brand.
Direct API
RESTful API for custom integrations and programmatic access.
Permissions
Corral AI uses a role-based permission system:
- Owner: Full control over workspace and all resources
- Admin: Manage agents and projects, but cannot delete workspace
- Editor: Create and modify agents
- Viewer: Read-only access to agents and analytics
Data Flow
Understanding how data flows through Corral is important for security planning:
Important: All data processing happens within your Azure tenant. No data is sent to external services unless you explicitly configure external tool integrations.
Next Steps
Now that you understand the core concepts: