Skip to main content

Agility

Ai12z Agility Connector Setup Guide

Step 1: Enable Connector

  1. Log in to the Ai12z portal using admin credentials.
  2. In the organization settings, verify that the connectors are enabled. Organization settings screen showing enabled connectors
  3. Navigate to your Agent.
  4. Select Agent Settings.
  5. Click on the edit button next to Connectors and enable Agility.

Step 2: Configure Connector

  1. Select Connectors from the Agent left navigation.
  2. From the connector list, click on Agility
  3. In the Connector Configuration screen, fill out the information
    • Agility GUID - The GUID Id is from the CMS Portal.
    • Agility API Fetch Token - The API token to read the content from the CMS.
    • Site URL - The rest api path for ai12z to use.
    • Channels - In which channel we are accessing the API (e.g. website)
    • Agility Models - Where the laguage specfic urls with key values
      {
      "langCode": "en-us",
      "url": "https://agility-example.vercel.app"
      }
  4. Continue with Save action.
  5. Once the configured was successfully saved, now the "Configure Webhook" action and "Sync Now" action button are enabled to trigger it.

2.1 Configure Webhook

  1. Click on the "Configure Webhook" button.
  2. It will prompt you to OAuth with Agility.
  3. Follow the OAuth flow to authorize Ai12z to access your Agility account.
  4. Once authorized, the webhook will be configured to receive updates from Agility.
  5. Continue with Save action.
  6. The webhook will now be set up to listen for changes in Agility content.

2.2 Sync Now

  1. Click on the "Sync Now" button to initiate a content sync.
  2. This will fetch the latest content from Agility and update it in Ai12z.
  3. The sync process may take some time depending on the amount of content.
  4. Once the sync is complete, you will see a confirmation message indicating that the content has been successfully synced.
  5. You can now access the Agility content through Ai12z.

Step 3: Verify Integration

  1. Navigate to the Ai12z Agent where you configured the Agility connector.
  2. Get into the Documents section and select the Agility connector document.
  3. Verify that the content from Agility is being displayed correctly under the Vector tab.
  4. You can also test the integration by querying the Agility content through the Ai12z Agent.