Webex

WebexTools enable an Agent to interact with Cisco Webex, allowing it to send messages and list rooms.

Prerequisites

The following example requires the webexpythonsdk library and a Webex access token which can be obtained from Webex Developer Portal.

To get started with Webex:

Create a Webex Bot:
- Go to the Developer Portal
- Navigate to My Webex Apps → Create a Bot
- Fill in the bot details and click Add Bot
Get your access token:
- Copy the token shown after bot creation
- Or regenerate via My Webex Apps → Edit Bot
- Set as WEBEX_ACCESS_TOKEN environment variable
Add the bot to Webex:
- Launch Webex and add the bot to a space
- Use the bot's email (e.g. test@webex.bot)

1uv pip install webexpythonsdk

1export WEBEX_ACCESS_TOKEN=your_access_token_here

Example

The following agent will list all spaces and send a message using Webex:

1from kern.agent import Agent
2from kern.tools.webex import WebexTools
3
4agent = Agent(tools=[WebexTools()])
5
6# List all spaces in Webex
7agent.print_response("List all space on our Webex", markdown=True)
8
9# Send a message to a Space in Webex
10agent.print_response(
11    "Send a funny ice-breaking message to the webex Welcome space", markdown=True
12)

Toolkit Params

Parameter	Type	Default	Description
`access_token`	`str`	`None`	Webex access token for authentication. If not provided, uses WEBEX_ACCESS_TOKEN environment variable.
`enable_send_message`	`bool`	`True`	Enable sending messages to Webex spaces.
`enable_list_rooms`	`bool`	`True`	Enable listing Webex spaces/rooms.
`all`	`bool`	`False`	Enable all functionality.

Toolkit Functions

Function	Description
`send_message`	Sends a message to a Webex room. Parameters: `room_id` (str) for the target room, `text` (str) for the message.
`list_rooms`	Lists all available Webex rooms/spaces with their details including ID, title, type, and visibility settings.

Developer Resources

View Tools