Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Insighto AI

Scalekit connector
Open markdown

The Insighto AI connector lets your AI agent act in each user's Insighto AI account. Each user connects their own Insighto AI API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
28 · 23 · 928 read23 write9 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Insighto AI connection

    In AgentKit > Connections, create an Insighto AI connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'insighto'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Insighto AI:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'insighto_assistants_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Insighto AI credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • insighto_assistant_data_sources_listList the knowledge data sources linked to an assistant.Read-only

    List Assistant Data Sources

    List the knowledge data sources linked to an assistant. Returns data (items, total, page, size, pages, previous_page, next_page). Get assistant IDs from insighto_assistants_list.

    Inputs

    assistant_idstringrequired
    Assistant ID. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa2
    pageinteger
    Page number, starting at 1. Example: 1
    sizeinteger
    Number of records per page. Example: 50
  • insighto_assistant_getGet one assistant's configuration.Read-only

    Get Assistant

    Get one assistant's configuration. Returns data (assistant_type, llm_model, name, description, attributes, system_prompt, voice, custom_voice, voice_languages, org_id). Get assistant IDs from insighto_assistants_list.

    Inputs

    assistant_idstringrequired
    Assistant ID. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa2
  • insighto_assistant_intents_listList the intents linked to an assistant.Read-only

    List Assistant Intents

    List the intents linked to an assistant. Returns data (items, total, page, size, pages, previous_page, next_page). Get assistant IDs from insighto_assistants_list.

    Inputs

    assistant_idstringrequired
    Assistant ID. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa2
    pageinteger
    Page number, starting at 1. Example: 1
    sizeinteger
    Number of records per page. Example: 50
  • insighto_assistant_widgets_listList the widgets (deployments) linked to an assistant.Read-only

    List Assistant Widgets

    List the widgets (deployments) linked to an assistant. Returns data (items, total, page, size, pages, previous_page, next_page). Get assistant IDs from insighto_assistants_list.

    Inputs

    assistant_idstringrequired
    Assistant ID. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa2
    pageinteger
    Page number, starting at 1. Example: 1
    sizeinteger
    Number of records per page. Example: 50
  • insighto_assistants_listList AI assistants with paging.Read-only

    List Assistants

    List AI assistants with paging. Returns data (items, total, page, size, pages, previous_page, next_page). Use insighto_assistant_get for one assistant's configuration.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1
    sizeinteger
    Number of records per page. Example: 50
  • insighto_campaign_getGet one campaign.Read-only

    Get Campaign

    Get one campaign. Returns data (name, widget_id, type, attributes, status, execution_weekdays, time_window_start, time_window_end, time_zone, start_time). Get campaign IDs from insighto_campaigns_list.

    Inputs

    campaign_idstringrequired
    Campaign ID. Example: 3fa85f64-5717-4562-b3fc-2c963f66afa9
  • insighto_campaigns_listList campaigns with paging.Read-only

    List Campaigns

    List campaigns with paging. Returns data (items, total, page, size, pages, previous_page, next_page). Use insighto_campaign_get for one campaign.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1
    sizeinteger
    Number of records per page. Example: 50
  • insighto_captured_intents_listList intents captured in conversations, with paging.Read-only

    List Captured Intents

    List intents captured in conversations, with paging. Returns data (items, total, page, size, pages, previous_page, next_page). Use insighto_intents_list for intent definitions.

    Inputs

    pageinteger
    Page number, starting at 1. Example: 1
    sizeinteger
    Number of records per page. Example: 50