DocsUseful Plugins

Useful Plugins

Built-in

Pre-built plugins from connectonion.useful_plugins

What is a Plugin?

A plugin is a reusable list of event handlers. Use plugins=[...] to add pre-packaged functionality to any agent.

main.py

from connectonion import Agent
from connectonion.useful_plugins import re_act, image_result_formatter

# Combine multiple plugins
agent = Agent(
    "assistant",
    tools=[search, screenshot],
    plugins=[re_act, image_result_formatter]
)

Learn how to build custom plugins in the Plugin System documentation.

ReAct Pattern

re_act

Implements Reason + Act pattern with planning before action and reflection after tool execution

after_user_input (plan)after_tools (reflect)

Code Evaluation

eval

Safe code evaluation and execution in a sandboxed environment

after_tools

Image Result Formatter

image_result_formatter

Automatically formats base64 images in tool results for vision models (GPT-4o, etc.)

after_each_tool

Gmail Plugin

gmail_plugin

Pre-configured event handlers for Gmail integration workflows

after_user_inputafter_tools

Calendar Plugin

calendar_plugin

Pre-configured event handlers for calendar management workflows

after_user_inputafter_tools

Shell Approval

shell_approval

Requires user confirmation before executing shell commands for safety

before_each_tool

System Reminder

system_reminder

Injects contextual guidance into tool results to nudge agent behavior

after_each_tool

Combining Plugins

Plugins can be combined for powerful agent behaviors:

main.py

from connectonion import Agent
from connectonion.useful_plugins import (
    re_act,              # Planning + Reflection
    image_result_formatter,  # Vision support
    shell_approval       # Safety for shell commands
)

agent = Agent(
    "devops_assistant",
    tools=[run_command, screenshot, analyze],
    plugins=[re_act, image_result_formatter, shell_approval]
)

# Now the agent will:
# 1. Plan before acting (re_act)
# 2. Format images for vision models (image_result_formatter)
# 3. Ask for approval before shell commands (shell_approval)
# 4. Reflect after tool execution (re_act)

Customizing Plugins

Need to modify a built-in plugin? Copy it to your project:

code

# Copy a plugin to your project
co copy re_act

# Copy multiple plugins
co copy re_act shell_approval eval

Python REPL

Interactive

✓ Copied: ./plugins/re_act.py

✓ Copied: ./plugins/shell_approval.py

✓ Copied: ./plugins/eval.py

Then import from your local copy and customize:

main.py

# Before (from package)
from connectonion.useful_plugins import re_act

# After (from your copy)
from plugins.re_act import re_act  # Customize freely!

See co copy for full details.

Build Your Own Plugin

Learn how to create custom plugins using the event system

Plugin System Docs

WebFetch

re_act