Platform Abilities

Abilities represent pre-built, configurable functionality that you can integrate into your conversational AI agents. Each ability encapsulates specific capabilities such as web searching, code execution, file processing, or integration with external services like Google Calendar, Notion, or Slack.

Discovering Available Abilities

The platform provides a comprehensive catalog of abilities that you can browse and integrate into your applications. Each ability comes with a detailed schema defining its configuration parameters, making it easy to understand what inputs are required and how to configure the ability for your specific use case.

To retrieve the list of all available platform abilities, send a GET request to the abilities endpoint:

The response includes an array of ability objects, each containing:

• id: Unique identifier for the ability
• name: Human-readable name of the ability
• description: Detailed explanation of what the ability does
• icon: Visual icon identifier for UI representation
• schema: JSON schema defining configuration parameters
• setup: Optional setup instructions for the ability
• commentary: Additional context or usage notes

Understanding Ability Schemas

Each ability includes a JSON schema that defines its configuration structure. The schema specifies the parameters that can be configured, their types, whether they're required or optional, enumerated values for select fields, and default values. This schema-driven approach ensures type safety and provides clear documentation for how to configure each ability.

Integration Considerations

When integrating abilities into your agents or applications, review the schema carefully to understand configuration requirements. Some abilities may require external API keys or authentication credentials, which should be securely stored and referenced through the platform's secret management system. The setup field provides guidance on any prerequisite steps needed before using an ability.

Note: The list of available abilities may vary based on your subscription plan and account permissions. Some advanced abilities may require specific plan levels or additional configuration.