# vishnu1234555/automation_agent architecture

> Architecture diagram of the GitHub repository vishnu1234555/automation_agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vishnu1234555/automation_agent
- Repository: https://github.com/vishnu1234555/automation_agent

## Overview

OmniOrchestrator is an interactive workspace agent that turns user requests into tool calls across Slack, Notion, Airtable, Jira, and Discord. Its conversation loop tries Google ADK models first, then falls back to Groq; Groq schemas are compiled from tool signatures, and selected integration functions call their platform APIs. The README documents the tool capabilities, while sampled source confirms engine setup, compilation, and several API calls. Some tool registration and cascade details are only partially excerpted, so those edges cite the README where appropriate.

Main entry points: [`agent.py`](https://github.com/vishnu1234555/automation_agent/blob/main/agent.py) (Groq engine), [`Slack.py`](https://github.com/vishnu1234555/automation_agent/blob/main/Slack.py) (Slack tools), [`Notion.py`](https://github.com/vishnu1234555/automation_agent/blob/main/Notion.py) (Notion search), [`airtable_tools.py`](https://github.com/vishnu1234555/automation_agent/blob/main/airtable_tools.py) (Airtable tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Conversation orchestration"]
  node_loop["Interactive loop<br/>[agent.py]"]
  node_google["Google ADK engine<br/>[agent.py]"]
  node_groq["Groq engine<br/>[agent.py]"]
end

subgraph group_schemas["Tool schemas"]
  node_compiler["Schema compiler<br/>[tool_compiler.py]"]
end

subgraph group_integrations["Workspace integrations"]
  node_slack["Slack tools<br/>[Slack.py]"]
  node_notion_search["Notion search<br/>[Notion.py]"]
  node_notion_data["Notion database and page tools<br/>[Notion.py]"]
  node_airtable["Airtable tools<br/>[airtable_tools.py]"]
  node_jira["Jira tools<br/>[jira_tools.py]"]
  node_discord["Discord tools<br/>[discord_tools.py]"]
end

subgraph group_services["External platforms"]
  node_google_api{{"Google ADK service"}}
  node_groq_api{{"Groq API"}}
  node_slack_api{{"Slack API"}}
  node_notion_api{{"Notion API"}}
  node_airtable_api{{"Airtable API"}}
  node_jira_api{{"Jira API"}}
  node_discord_api{{"Discord API"}}
end

node_user(("User"))

node_user -->|"enters request"| node_loop
node_loop -->|"tries first"| node_google
node_loop -->|"falls back"| node_groq
node_google -->|"runs models"| node_google_api
node_groq -->|"requests completion"| node_groq_api
node_groq -->|"compiles tools"| node_compiler
node_google -->|"invokes registered tools"| node_slack
node_google -->|"invokes registered tools"| node_notion_search
node_google -->|"invokes registered tools"| node_notion_data
node_google -->|"invokes registered tools"| node_airtable
node_google -->|"invokes registered tools"| node_jira
node_google -->|"invokes registered tools"| node_discord
node_groq -->|"dispatches tools"| node_slack
node_groq -->|"dispatches tools"| node_notion_search
node_groq -->|"dispatches tools"| node_notion_data
node_groq -->|"dispatches tools"| node_airtable
node_groq -->|"dispatches tools"| node_jira
node_groq -->|"dispatches tools"| node_discord
node_slack -->|"calls API"| node_slack_api
node_notion_search -->|"searches pages"| node_notion_api
node_notion_data -->|"reads and writes"| node_notion_api
node_airtable -->|"reads and updates"| node_airtable_api
node_jira -->|"searches and creates"| node_jira_api
node_discord -->|"reads and posts"| node_discord_api

click node_loop "https://github.com/vishnu1234555/automation_agent/blob/main/agent.py"
click node_google "https://github.com/vishnu1234555/automation_agent/blob/main/agent.py"
click node_groq "https://github.com/vishnu1234555/automation_agent/blob/main/agent.py"
click node_compiler "https://github.com/vishnu1234555/automation_agent/blob/main/tool_compiler.py"
click node_slack "https://github.com/vishnu1234555/automation_agent/blob/main/Slack.py"
click node_notion_search "https://github.com/vishnu1234555/automation_agent/blob/main/Notion.py"
click node_notion_data "https://github.com/vishnu1234555/automation_agent/blob/main/Notion.py"
click node_airtable "https://github.com/vishnu1234555/automation_agent/blob/main/airtable_tools.py"
click node_jira "https://github.com/vishnu1234555/automation_agent/blob/main/jira_tools.py"
click node_discord "https://github.com/vishnu1234555/automation_agent/blob/main/discord_tools.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_loop,node_google,node_groq,node_user toneBlue
class node_compiler toneAmber
class node_slack,node_notion_search,node_notion_data,node_airtable,node_jira,node_discord toneMint
class node_google_api,node_groq_api,node_slack_api,node_notion_api,node_airtable_api,node_jira_api,node_discord_api toneRose
```

## Components

### Conversation orchestration

- [Interactive loop](https://github.com/vishnu1234555/automation_agent/blob/main/agent.py): `agent.py`
- [Google ADK engine](https://github.com/vishnu1234555/automation_agent/blob/main/agent.py): `agent.py`
- [Groq engine](https://github.com/vishnu1234555/automation_agent/blob/main/agent.py): `agent.py`

### Tool schemas

- [Schema compiler](https://github.com/vishnu1234555/automation_agent/blob/main/tool_compiler.py): `tool_compiler.py`

### Workspace integrations

- [Slack tools](https://github.com/vishnu1234555/automation_agent/blob/main/Slack.py): `Slack.py`
- [Notion search](https://github.com/vishnu1234555/automation_agent/blob/main/Notion.py): `Notion.py`
- [Notion database and page tools](https://github.com/vishnu1234555/automation_agent/blob/main/Notion.py): `Notion.py`
- [Airtable tools](https://github.com/vishnu1234555/automation_agent/blob/main/airtable_tools.py): `airtable_tools.py`
- [Jira tools](https://github.com/vishnu1234555/automation_agent/blob/main/jira_tools.py): `jira_tools.py`
- [Discord tools](https://github.com/vishnu1234555/automation_agent/blob/main/discord_tools.py): `discord_tools.py`

### External platforms

- **Google ADK service**
- **Groq API**
- **Slack API**
- **Notion API**
- **Airtable API**
- **Jira API**
- **Discord API**

### Other components

- **User**

## Connections

- User → Interactive loop: enters request (evidence: `README.md`)
- Interactive loop → Google ADK engine: tries first (evidence: `README.md`)
- Interactive loop → Groq engine: falls back (evidence: `README.md`)
- Google ADK engine → Google ADK service: runs models (evidence: `agent.py`)
- Groq engine → Groq API: requests completion (evidence: `agent.py`)
- Groq engine → Schema compiler: compiles tools (evidence: `agent.py`)
- Google ADK engine → Slack tools: invokes registered tools (evidence: `agent.py`)
- Google ADK engine → Notion search: invokes registered tools (evidence: `agent.py`)
- Google ADK engine → Notion database and page tools: invokes registered tools (evidence: `agent.py`)
- Google ADK engine → Airtable tools: invokes registered tools (evidence: `agent.py`)
- Google ADK engine → Jira tools: invokes registered tools (evidence: `agent.py`)
- Google ADK engine → Discord tools: invokes registered tools (evidence: `agent.py`)
- Groq engine → Slack tools: dispatches tools (evidence: `README.md`)
- Groq engine → Notion search: dispatches tools (evidence: `README.md`)
- Groq engine → Notion database and page tools: dispatches tools (evidence: `README.md`)
- Groq engine → Airtable tools: dispatches tools (evidence: `README.md`)
- Groq engine → Jira tools: dispatches tools (evidence: `README.md`)
- Groq engine → Discord tools: dispatches tools (evidence: `README.md`)
- Slack tools → Slack API: calls API (evidence: `Slack.py`)
- Notion search → Notion API: searches pages (evidence: `Notion.py`)
- Notion database and page tools → Notion API: reads and writes (evidence: `Notion.py`)
- Airtable tools → Airtable API: reads and updates (evidence: `airtable_tools.py`)
- Jira tools → Jira API: searches and creates (evidence: `jira_tools.py`)
- Discord tools → Discord API: reads and posts (evidence: `discord_tools.py`)
