Create Slack Client Connector Instances for AI Agent Studio

You can integrate Slack with AI Agent Studio and enable users to access published Oracle AI workflows from Slack. After integration, users in the workspace can open the configured Slack app in Slack and interact with the AI workflows available to them.

Note: Make sure that the Slack user has the necessary access permissions to interact with AI agents. For more information, see How can I give users access to AI agents?

The setup process involves these high-level steps:

1. Create a Connector for Slack in AI Agent Studio
2. Download the Manifest File
3. Create Slack App for AI Agents
4. Update the Connector in AI Agent Studio
5. Add the Slack App

Create a Connector for Slack in AI Agent Studio

Prerequisite: You need to assign the ORA_DR_FAI_GENERATIVE_AI_AGENT_COLLAB_TOOLS_DUTY duty role to your job role. For more information, see Access Requirements for AI Agent Studio.

1. Go to Tools > AI Agent Studio.
2. Click the Connectors tab.
3. Click Add Connector.
4. Search for the Slack (Client) connector and click +.
5. Provide the name for the connector, select the family and product, and provide a description.
6. Enter details for the channel manifest file.
   • Name: Enter the short name for the app.
   • Manifest Schema Version: Select the schema version that's to be used for the manifest file.
   • App Display Name: Enter a display name for the app.
7. Click Create.

Download the Manifest File

1. In AI Agent Studio, click the Connectors tab.
2. Under Configured connectors, click the connector you created in AI Agent Studio.
3. Under Attachments, click the download icon next to manifest.json.
4. Save the manifest.json file to a location of your choice.

Create Slack App for AI Agents

1. Go to https://api.slack.com/apps and select Create New App.
2. Select From a manifest, choose the workspace, and click Next.
3. In the JSON tab, paste the manifest details copied from the manifest.json file created in AI Agent Studio.
4. In the manifest, append the app_id and workspace_id query parameters to both: event_subscriptions.request_url and interactivity.request_url.
   Where workspace_id is the Slack workspace's Team ID. To locate the workspace_id:

   1. Open Slack in your browser.
   2. Copy the URL for the channel in that workspace.
   3. The value after /client/ is the workspace ID.

      For example, in "https://app.slack.com/client/T012ABC3DEF/C012ABC3DEF", the workspace_id is T012ABC3DEF.

   Manifest example:

   "settings": { 
     "event_subscriptions": { 
       "request_url": "https://<fusion-url>/api/fusion-ai/orchestrator/collabTools/v1/slack/events?workspace_id=T09HN0WLDAN&app_id=A0B67U52QR2", 
       "bot_events": [ 
         "message.im" 
       ] 
     }, 
     "interactivity": { 
       "is_enabled": true, 
       "request_url": "https://<fusion-url>/api/fusion-ai/orchestrator/collabTools/v1/slack/interactivity?workspace_id=T09HN0WLDAN&app_id=A0B67U52QR2" 
     } 
   }

5. Click Next and create the app.
6. Select the app you created and go to Settings > Basic Information.
7. Note down these credentials for later use:
   • App ID
   • Client ID
   • Client Secret
   • Signing Secret
8. Go to Settings > Install App and install the app.
9. Make a note of the Bot User OAuth Token value.
10. Go to Features > Event Subscriptions and check if the Request URL is successfully verified. If it isn't verified, select Retry.

Update the Connector in AI Agent Studio

1. In AI Agent Studio, click the Connectors tab.
2. Under Configured connectors, click the Slack connector you created in AI Agent Studio.
3. Under Bot configuration, for Configure Bot Credentials, click True.
4. Enter details for the bot configuration:
   • App ID
   • Workspace ID
   • Verification Token
   • Client ID
   • Client Secret
   • Bot OAuth Token
   • Signing Secret
   • IDCS Client ID
   • IDCS Client Secret
5. Click Update.

Add the Slack App

1. Open the Slack application and select Add apps.
2. Add the configured Slack app.

   Users in the workspace can now interact with the Oracle AI agents they have access to.