AutoGen

This guide explains how to use Integry with AutoGen to post a message on Slack.

1. Install Required Libraries

First, you need to install the necessary packages:

Integry requires Python version 3.12 or higher

  • Integry is used to integrate structured tools and functions.

  • AutoGen integrate tools and automate workflows using large language models.

pip install integry autogen

2. Initialize Integry & Agent

Import the necessary Libraries

import os
from integry import Integry
from autogen import ConversableAgent, register_function

User-ID is a unique string identifier for a user in your app or agent. Function Calls and Integrations are associated to a user ID. It will be the email address you used during the signup process on Integry.

For example:

user_id = "joe@example.com"

Below code snippet initializes the Integry class to interact with the Integry API using the App-Key and App-Secret.

You can view and copy your App-Key and App-Secret from the Workspace Settings.

integry = Integry(
    app_key=os.environ.get("INTEGRY_APP_KEY"),
    app_secret=os.environ.get("INTEGRY_APP_SECRET"),
)

The code creates two AI agents: one is "Assistant" that helps perform tasks, and another is "User" that listens for a TERMINATE message to stop.

The assistant uses an API key for GPT-4 You can get the API Key from the OpenAI Platform, while the user agent has a rule to stop when it receives the TERMINATE message.

llm_config = {"config_list": [{"model": "gpt-4o", "api_key": os.environ.get("OPENAI_API_KEY")}]}

assistant = ConversableAgent(
    name="Assistant",
    system_message="You are a helpful integrations assistant. "
    "You can help users perform tasks in various apps. "
    "Return 'TERMINATE' when the task is done.",
    llm_config=llm_config,
)

user_proxy = ConversableAgent(
    name="User",
    llm_config=False,
    is_termination_msg=lambda msg: msg.get("content") is not None
    and "TERMINATE" in msg["content"],
    human_input_mode="NEVER",
)

3. Register an Integry Function as a Tool

Before you can use the functions available in Integry, you need to add the app to Integry. Slack, however, is pre-added to Integry by default, so there’s no need to add it manually.

The code retrieves a Slack post-message function from Integry. You can copy the function ID from the dropdown.

For example

In this case the function ID is slack-post-message

After getting the function ID, we then registers it with the Autogen AI agents to enable the assistant to call the function.

function = await integry.functions.get("slack-post-message", user_id)

function.register_with_autogen_agents(
    register_function,
    caller=assistant,
    executor=user_proxy,
    user_id=user_id,
)

4. Connect Your Slack Account

To allow the agent to send a message on Slack on your user's behalf, the user must connect their Slack account. To connect a Slack account against the provided user ID, execute the following snippet.

slack = await integry.apps.get("slack", user_id)
print(slack.login_url)

This will print a URL which can be opened in a web browser to connect Slack.

5. Execute Agent

This will execute the agent and send a Hello from autogen to the team message in the Slack random channel.

chat_result = await user_proxy.a_initiate_chat(
    assistant,
    message="Say hello from autogen to my team on slack in #random channel",
)

This will send the message to the slack channel. Here is reference image

The message has been sent successfully in slack #random channel. You can verify the successful message delivery by checking the highlighted content in the response below.

PreviousCrewAINextLlamaIndex

Last updated