Octopus
Built-In Tools
Octopus plugins provide built-in tools that are automatically available when the plugin is active. The ProcessPlugin provides workflow and handoff tools. The WebDriverPlugin provides browser automation tools. This page documents all built-in tools grouped by plugin.
ProcessPlugin Tools
Available when the ProcessPlugin is active. Enables agents to trigger Flow Studio workflows and hand off to other agents:
| Tool Name | Description | Key Parameters |
|---|---|---|
start_workflow | Triggers a Flow Studio workflow by definition ID | workflowDefinitionId, inputData (JSON) |
get_workflow_status | Returns the current status of a running workflow instance | workflowInstanceId |
handoff_to_agent | Transfers the conversation to a specialist agent | targetAgentId, reason, contextSummary |
request_human_approval | Suspends workflow and sends an approval request to a human actor | workflowInstanceId, approvalMessage, actorUserId |
start_workflow Tool Schema
{
"name": "start_workflow",
"description": "Triggers a Flow Studio workflow. Use this to initiate multi-step business processes such as vendor onboarding, expense approvals, or employee offboarding. Returns the workflow instance ID.",
"input_schema": {
"type": "object",
"properties": {
"workflowDefinitionId": {
"type": "string",
"description": "The Flow Studio workflow definition ID to start"
},
"inputData": {
"type": "object",
"description": "Initial data to pass into the workflow as input parameters"
},
"correlationId": {
"type": "string",
"description": "Optional correlation ID to link this workflow to an external entity"
}
},
"required": ["workflowDefinitionId"]
}
}WebDriverPlugin Tools
Available when the WebDriverPlugin is active. Enables agents to control a browser for web automation tasks:
| Tool Name | Description |
|---|---|
browser_navigate | Navigate to a URL |
browser_click | Click an element by CSS selector or XPath |
browser_type | Type text into an input field |
browser_get_text | Extract text from a page element |
browser_screenshot | Take a screenshot of the current page (returned as base64) |
browser_wait | Wait for an element to appear or a condition to be true |
ChatbotUIPlugin Tools
The ChatbotUIPlugin provides tools for controlling the chat interface from the agent's side:
| Tool Name | Description |
|---|---|
show_form | Render an Atlas Form in the chat for user data collection |
show_card | Display a structured data card (table, key-value pairs) in the chat |
request_file_upload | Prompt the user to upload a file; returns file reference |
show_confirmation | Display a Yes/No confirmation button to the user |
SemanticKernelPlugin Tools
| Tool Name | Description |
|---|---|
search_knowledge | Explicitly search the knowledge base (in addition to automatic RAG injection) |
summarize_text | Call the LLM to summarize a long text passage using a dedicated summarization prompt |
translate_text | Translate text to a target language using the configured LLM |