A programming framework for agentic AI
Introducing AutoAnny: A New Discord Bot Built with AutoGen (#1501)
gagbe0fa6ee55bdd
diff --git a/samples/apps/auto-anny/README.md b/samples/apps/auto-anny/README.mdnew file mode 100644index 000000000..34199c8c7--- /dev/null+++ b/samples/apps/auto-anny/README.md@@ -0,0 +1,43 @@+<div align="center">+ <img src="images/icon.png" alt="Repo Icon" width="100" height="100">+</div>++# AutoAnny++AutoAnny is a Discord bot built using AutoGen to help with AutoGen's Discord server.+Actually Anny can help with any OSS GitHub project (set `ANNY_GH_REPO` below).++## Features++- **`/heyanny help`**: Lists commands.+- **`/heyanny ghstatus`**: Summarizes GitHub activity.+- **`/heyanny ghgrowth`**: Shows GitHub repo growth indicators.+- **`/heyanny ghunattended`**: Lists unattended issues and PRs.++## Installation++1. Clone the AutoGen repository and `cd samples/apps/auto-anny`+2. Install dependencies: `pip install -r requirements.txt`+3. Export Discord token and GitHub API token,+ ```+ export OAI_CONFIG_LIST=your-autogen-config-list+ export DISCORD_TOKEN=your-bot-token+ export GH_TOKEN=your-gh-token+ export ANNY_GH_REPO=microsoft/autogen # you may choose a different repo name+ ```+ To get a Discord token, you will need to set up your Discord bot using these [instructions](https://discordpy.readthedocs.io/en/stable/discord.html).+4. Start the bot: `python bot.py`++Note: By default Anny will log data to `autoanny.log`.+++## Roadmap++- Enable access control+- Enable a richer set of commands+- Enrich agents with tool use+++## Contributing++Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.diff --git a/samples/apps/auto-anny/agent_utils.py b/samples/apps/auto-anny/agent_utils.pynew file mode 100644index 000000000..2cbb97c94--- /dev/null+++ b/samples/apps/auto-anny/agent_utils.py@@ -0,0 +1,36 @@+from autogen import AssistantAgent, UserProxyAgent, config_list_from_json+++async def solve_task(task):+ config_list = config_list_from_json(env_or_file="OAI_CONFIG_LIST")+ assistant = AssistantAgent("assistant", llm_config={"config_list": config_list})+ user_proxy = UserProxyAgent(+ "user_proxy",+ code_execution_config={"work_dir": "coding", "use_docker": False},+ human_input_mode="NEVER",+ is_termination_msg=lambda msg: "TERMINATE" in msg.get("content", ""),+ )+ await user_proxy.a_initiate_chat(assistant, message=task)++ await user_proxy.a_send(+ f"""Based on the results in above conversation, create a response for the user.+While computing the response, remember that this conversation was your inner mono-logue.+The user does not need to know every detail of the conversation.+All they want to see is the appropriate result for their task (repeated below) in+ a manner that would be most useful. Response should be less than 1500 characters.++ The task was: {task}++There is no need to use the word TERMINATE in this response.++""",+ assistant,+ request_reply=False,+ silent=True,+ )+ response = await assistant.a_generate_reply(assistant.chat_messages[user_proxy], user_proxy)+ await assistant.a_send(response, user_proxy, request_reply=False, silent=True)++ last_message = assistant.chat_messages[user_proxy][-1]["content"]++ return last_message[:2000]diff --git a/samples/apps/auto-anny/bot.py b/samples/apps/auto-anny/bot.pynew file mode 100644index 000000000..ef3759c73--- /dev/null+++ b/samples/apps/auto-anny/bot.py@@ -0,0 +1,153 @@+import os+import logging+import logging.handlers++import discord+from discord.ext import commands++from agent_utils import solve_task++logger = logging.getLogger("anny")+logger.setLevel(logging.INFO)+logging.getLogger("discord.http").setLevel(logging.INFO)++handler = logging.handlers.RotatingFileHandler(+ filename="autoanny.log",+ encoding="utf-8",+ maxBytes=32 * 1024 * 1024, # 32 MiB+ backupCount=5, # Rotate through 5 files+)+dt_fmt = "%Y-%m-%d %H:%M:%S"+formatter = logging.Formatter("[{asctime}] [{levelname:<8}] {name}: {message}", dt_fmt, style="{")+handler.setFormatter(formatter)+logger.addHandler(handler)++required_env_vars = ["OAI_CONFIG_LIST", "DISCORD_TOKEN", "GH_TOKEN", "ANNY_GH_REPO"]+for var in required_env_vars:+ if var not in os.environ:+ raise ValueError(f"{var} environment variable is not set.")++# read token from environment variable+DISCORD_TOKEN = os.environ["DISCORD_TOKEN"]+REPO = os.environ["ANNY_GH_REPO"]++intents = discord.Intents.default()+intents.message_content = True+intents.reactions = True+bot = commands.Bot(command_prefix="/", intents=intents)+++async def on_message(message):+ logger.info({"message": message.content, "author": message.author, "id": message.id})+ await bot.process_commands(message)+++async def on_reaction_add(reaction, user):+ message = reaction.message+ logger.info(+ {+ "message": message.content,+ "author": message.author,+ "id": message.id,+ "reaction": reaction.emoji,+ "reactor": user,+ }+ )+++async def on_ready():+ logger.info("Logged in", extra={"user": bot.user})++[email protected](description="Invoke Anny to solve a task.")+async def heyanny(ctx, task: str = None):+ if not task or task == "help":+ response = help_msg()+ await ctx.send(response)+ return++ task_map = {+ "ghstatus": ghstatus,+ "ghgrowth": ghgrowth,+ "ghunattended": ghunattended,+ "ghstudio": ghstudio,+ }++ if task in task_map:+ await ctx.send("Working on it...")+ response = await task_map[task](ctx)+ await ctx.send(response)+ else:+ response = "Invalid command! Please type /heyanny help for the list of commands."+ await ctx.send(response)+++def help_msg():+ response = f"""+Hi this is Anny an AutoGen-powered Discord bot to help with `{REPO}`. I can help you with the following tasks:+- ghstatus: Find the most recent issues and PRs from today.+- ghgrowth: Find the number of stars, forks, and indicators of growth.+- ghunattended: Find the most issues and PRs from today from today that haven't received a response/comment.++You can invoke me by typing `/heyanny <task>`.+"""+ return response+++async def ghstatus(ctx):+ response = await solve_task(+ f"""+ Find the most recent issues and PRs from `{REPO}` in last 24 hours.+ Separate issues and PRs.+ Final response should contains title, number, date/time, URLs of the issues and PRs.+ Markdown formatted response will make it look nice.+ Make sure date/time is in PST and readily readable.+ You can access github token from the environment variable called GH_TOKEN.+ """+ )+ return response+++async def ghgrowth(ctx):+ response = await solve_task(+ f"""+ Find the number of stars, forks, and indicators of growth of `{REPO}`.+ Compare the stars of `{REPO}` this week vs last week.+ Make sure date/time is in PST and readily readable.+ You can access github token from the environment variable called GH_TOKEN.+ """+ )+ return response+++async def ghunattended(ctx):+ response = await solve_task(+ f"""+ Find the issues *created* in the last 24 hours from `{REPO}` that haven't+ received a response/comment. Modified issues don't count.+ Final response should contains title, number, date/time, URLs of the issues and PRs.+ Make sure date/time is in PST and readily readable.+ You can access github token from the environment variable called GH_TOKEN.+ """+ )+ return response+++async def ghstudio(ctx):+ # TODO: Generalize to feature name+ response = await solve_task(+ f"""+ Find issues and PRs from `{REPO}` that are related to the AutoGen Studio.+ The title or the body of the issue or PR should give you a hint whether its related.+ Summarize the top 5 common complaints or issues. Cite the issue/PR number and URL.+ Explain why you think this is a common issue in 2 sentences.+ You can access github token from the environment variable called GH_TOKEN.+ """+ )+ return response+++bot.run(DISCORD_TOKEN, log_handler=None)diff --git a/samples/apps/auto-anny/images/icon.png b/samples/apps/auto-anny/images/icon.pngnew file mode 100644index 000000000..00822f988Binary files /dev/null and b/samples/apps/auto-anny/images/icon.png differdiff --git a/samples/apps/auto-anny/requirements.txt b/samples/apps/auto-anny/requirements.txtnew file mode 100644index 000000000..13a0ba19c--- /dev/null+++ b/samples/apps/auto-anny/requirements.txt@@ -0,0 +1,2 @@+discord.py+pyautogendiff --git a/website/blog/2024-02-02-AutoAnny/img/AutoAnnyLogo.jpg b/website/blog/2024-02-02-AutoAnny/img/AutoAnnyLogo.jpgnew file mode 100644index 000000000..4ff257bccBinary files /dev/null and b/website/blog/2024-02-02-AutoAnny/img/AutoAnnyLogo.jpg differdiff --git a/website/blog/2024-02-02-AutoAnny/index.mdx b/website/blog/2024-02-02-AutoAnny/index.mdxnew file mode 100644index 000000000..7226f74e9--- /dev/null+++ b/website/blog/2024-02-02-AutoAnny/index.mdx@@ -0,0 +1,47 @@+---+title: "Anny: Assisting AutoGen Devs Via AutoGen"+authors:+ - gagb+tags: [AutoGen]+---++import AutoAnnyLogo from './img/AutoAnnyLogo.jpg';++<div style={{ display: "flex", justifyContent: "center" }}>+ <img src={AutoAnnyLogo} alt="AutoAnny Logo" style={{ width: "250px" }} />+</div>+<p align="center"><em>Anny is a Discord bot powered by AutoGen to help AutoGen's Discord server.</em></p>+++### TLDR++We are adding a new sample app called Anny-- a simple Discord bot powered+by AutoGen that's intended to assist AutoGen Devs. See `samples/apps/auto-anny` for details.++### Introduction++Over the past few months, AutoGen has experienced large growth in number of users and number of community requests and feedback.+However, accommodating this demand and feedback requires manually sifting through issues, PRs, and discussions on GitHub, as well as managing messages+ from AutoGen's 14000+ community members on Discord. There are many tasks that AutoGen's developer community has to perform everyday,+ but here are some common ones:+- Answering questions+- Recognizing and prioritizing bugs and features+- Maintaining responsiveness for our incredible community+- Tracking growth++This requires a significant amount of effort. Agentic-workflows and interfaces promise adding+ immense value-added automation for many tasks, so we thought *why don't we use AutoGen to make+ our lives easier?!* So we're turning to automation to help us and allow+ us to focus on what's most critical.++### Current Version of Anny+The current version of Anny is pretty simple -- it uses the Discord API and AutoGen to enable a bot+ that can respond to a set of commands.++For example, it supports commands like `/heyanny help` for command listing, `/heyanny ghstatus` for+ GitHub activity summary, `/heyanny ghgrowth` for GitHub repo growth indicators, and `/heyanny ghunattended` for listing unattended issues and PRs. Most of these commands use multiple AutoGen agents to accomplish these task.++To use Anny, please follow instructions in [`samples/apps/auto-anny`](https://github.com/microsoft/autogen/tree/main/samples/apps/auto-anny).++### Its Not Just for AutoGen+If you're an open-source developer managing your own project, you can probably relate to our challenges. We invite you to check out Anny and contribute to its development and roadmap.diff --git a/website/docs/Examples.md b/website/docs/Examples.mdindex 48e416a0c..db317310b 100644--- a/website/docs/Examples.md+++ b/website/docs/Examples.md@@ -29,6 +29,7 @@ Links to notebook examples:- Automated Chess Game Playing & Chitchatting by GPT-4 Agents - [View Notebook](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_chess.ipynb)- Automated Continual Learning from New Data - [View Notebook](https://github.com/microsoft/autogen/blob/main/notebook/agentchat_stream.ipynb)- [OptiGuide](https://github.com/microsoft/optiguide) - Coding, Tool Using, Safeguarding & Question Answering for Supply Chain Optimization+ - [AutoAnny](https://github.com/microsoft/autogen/tree/main/samples/apps/auto-anny) - A Discord bot built using AutoGen1. **Tool Use**