Wexa AI
  1. Wexa_sdk
Wexa AI
  • Wexa AI
  • Use Cases and Workflows
  • API Reference
  • Troubleshooting Guide
  • Onboarding
    • Getting Started with Wexa
    • Hire your AI Coworker
  • AI Coworker Creation
    • Create your First AI Coworker
    • Process Flows
    • Creating your First Agent
    • Schedule a Process Flow
    • Executing a Process Flow
    • Settings - Input Form
    • History
  • Tables
    • Intro to Tables
    • Adding records to Tables
    • Table Triggers
  • Knowledge Base
    • Intro to Knowledge Base
  • Connectors and MCP Servers
    • Adding a New Connector
    • Adding an MCP Server
    • Setting up Connectors Triggers
  • API Endpoints
    • Project
      • create project
      • Get all projects
      • Get project
      • update project
      • Delete project
      • Get project by proiectName
    • Agentflows
      • create agentflow
      • get agentflows
      • Get agentflow by projectId and UserId
      • get agentflow by id
      • Add skilled agent to agentflow
      • Update skilled agent
    • Connectors
      • Configure connector
      • Get config
      • Retrieve linkedin params
      • get connectors by projectid
      • get connector by Id
      • Delete a connector
      • connector update status
      • get all available trigger actions
    • Skills
      • create skill
      • get skills
      • get skills by category
      • get skills by id
      • skills by name
    • Executeflow
      • create executeflow
      • get executions
      • execute agentflow
      • pause executeflow
      • resume execution
      • cancel executeflow
      • get execution by execution id
      • get execution details for monitoring
    • Actions
      • Customer
        • get customer
        • Get credit history
      • create action
      • get action
    • Files
      • Connectors and MCP Servers
      • upload files
      • get files by fileid
      • get connector by fileid
      • get files by connector_id
    • Inbox
      • Create inbox
      • Update inbox at runtime
      • Update anamoly detection inbox
      • Update Preview Inbox
      • get inbox
    • Tags
      • tags
    • Dashboard
      • get dashboard
      • refresh dashboard
      • delete component in dashboard
    • Tasks
      • get tasks
      • get task by id
      • Pause running task
      • resume task
      • Stop task
    • Tables
      • Insert row in a table
      • Get records
      • Get record by id
      • Update record by id
      • create table
      • create database
      • get tables
      • get table names
      • delete record
      • delete a column
      • Insert column in a table
    • Settings
      • get settings
    • Marketplace
      • get all connectors
      • get marketplace coworkers
      • get marketplace coworker by id
    • Coworker schedules
      • get schedules
      • create coworker schedule
      • get schedule coworker by its id
      • update schedule by its id
      • delete schedule by its id
    • Analytics
      • Get analytics
    • Marketplace coworkers
      • hire a coworker
      • check marketplace coworker update
    • Available Connectors
      • Actions
    • Execution Details
      • Execution details
    • Knowledge Base
      • File Upload
    • Create apikey
      • Generate apikey
  • Wexa_sdk
    • Wexa Python SDK
    • Use Cases and Workflows
    • API Reference
    • Troubleshooting Guide
    • Onboarding
      • Getting Started with Wexa
      • Hire Your AI Coworker
    • AI Coworker Creation
      • Create Your First AI Coworker
      • Process Flows
      • Schedule a Process Flow
      • Creating Your First Agent
      • Executing a Process Flow
      • Settings - Input Form
      • History
    • Tables
      • Intro to Tables
      • Adding Records to Tables
      • Table Triggers
    • Knowledge Base
      • Intro to Knowledge Base
    • Connectors and MCP Servers
      • Adding a New Connector
      • Adding an MCP Server
      • Setting up Connector Triggers
    • API Endpoints
      • Project
        • Create Project
        • Get Projects
        • Get Project by ID
        • Update
        • Delete Project
        • Get project by proiectName
  1. Wexa_sdk

Troubleshooting Guide

Common Issues#

Coworker Not Executing#

When using the SDK to execute AgentFlows (AI Coworkers), ensure all agents within the coworker are assigned specific goals and tasks. Verify that the coworker is properly linked to its corresponding triggers and workflows.
SDK Troubleshooting Steps:
Common Causes:
Missing or invalid agentflow_id
Incomplete input_variables required by the workflow
AgentFlow not properly configured in Wexa Studio
Missing project permissions

API Calls Failing#

When connector API calls fail, double-check connector configurations using the SDK:
Authentication Issues:
Headers and Endpoints:
Verification Checklist:
✅ Authentication: Confirm that API keys or credentials are correctly entered in connector configuration
✅ Headers: Ensure all required headers are present and correctly formatted
✅ Endpoints: Validate that the API endpoints are correct and accessible
✅ Connector Status: Verify connector is active and properly configured
Refer to the Wexa Connectors Documentation for detailed setup instructions.

Table Not Updating#

When tables are not updating as expected through SDK operations:
Permission Checks:
Trigger Sequence Verification:
Common Causes:
AI Coworker lacks write permissions for the Wexa Table
Trigger sequence is incorrect
Table schema mismatch
Record ID not found

Debugging Tips#

Live Logs#

Utilize the SDK's execution monitoring APIs to view real-time logs of agent activities and identify where issues may be occurring:

Logger Skill Agents#

Implement Logger skill agents at critical points within your workflow to capture and record data for debugging purposes. Use the SDK to add logging capabilities:

Sandbox Mode#

Test individual agent logic using the SDK's execution APIs in a controlled manner. Start executions with test data to isolate and resolve issues without affecting the live environment:

Permissions & Security#

Scoped Credentials#

AI Coworkers operate using scoped credentials, ensuring they have access only to the resources necessary for their tasks. The SDK respects these permissions:

Per-Agent Access Control#

Assign specific access permissions to individual agents for Wexa Tables, enhancing data security and integrity. Use the SDK to configure agent permissions:

Encrypted Credential Stores#

Store all connector credentials in encrypted formats to protect sensitive information. The SDK handles authentication securely:

Platform Limits#

Free Plan Restrictions#

Maximum of 10 AI Coworkers per organization: When using the SDK, you can check the number of AgentFlows:

Wexa Tables#

Support up to 100,000 rows per table: Monitor table size using the SDK:

API Call Limits#

API call limits vary based on the connector type and subscription plan. The SDK includes automatic retry logic for rate-limited requests:
Refer to the Wexa Pricing Page for detailed information on API call limits.
For additional support and resources, consider exploring the Wexa AI Beginner Course, which offers step-by-step tutorials to help you effectively utilize Wexa AI's capabilities through the Python SDK.
Modified at 2026-01-02 08:29:15
Previous
API Reference
Next
Getting Started with Wexa