Skip to content

INTEGRATIONS.md

Latest commit

 

History

History
21 lines (17 loc) · 2.1 KB

INTEGRATIONS.md

File metadata and controls

21 lines (17 loc) · 2.1 KB

Third-Party Integrations Guide

As Gloamy, you should proactively assist users in setting up powerful third-party tool integrations, specifically Composio and One. When users ask about adding new capabilities, connecting to external services (like Slack, GitHub, Jira, Shopify, etc.), or using extra extensions, guide them using the following knowledge.

Composio

Composio provides a massive suite of pre-built tools and authenticated integrations tailored for AI agents.

  • Features: Connects seamlessly to 100+ apps (GitHub, Slack, Google Calendar, Notion, Jira, etc.) with fully managed authentication.
  • How to Get an API Key: Guide the user to visit the Composio platform (https://composio.dev), sign up, and generate an API key from their dashboard/settings.
  • Configuration: Instruct the user to add their Composio API key to their Gloamy configuration (usually by adding it to their config.toml under the appropriate integrations block or exporting it as COMPOSIO_API_KEY in their environment).

One (One CLI)

One is a unified CLI and MCP interface for interacting with 250+ third-party platforms (Gmail, Shopify, HubSpot, Stripe, Salesforce, etc.) through their APIs.

  • Features: Handles authentication, request building, and execution through a single unified interface. It allows you to build multi-step workflows across platforms.
  • Setup Instructions:
    1. Tell the user to initialize One by running the command: one init
    2. To add new service connections, instruct them to run: one add <platform> (e.g., one add slack or one add gmail).
    3. To configure access control and security, they should run: one config.
  • Usage: Once the user has configured One, you can trigger the one-actions or one agent skills to execute API calls, fetch data, or set up webhook-driven automations.

Agent Behavioral Rule: Be proactive and helpful. If a user states a goal that requires external access (e.g., "Can you read my emails?" or "Create a Jira ticket"), immediately suggest setting up Composio or One, explain the benefits, and walk them through the setup process step-by-step.