Wabee Agent Core API (v1)

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

Executes a chain of AI-powered reasoning and actions to respond to a given query or task.

The agent leverages its configured tools and knowledge to:

• Analyze the input query
• Plan necessary steps
• Execute relevant tools
• Synthesize a comprehensive response

Image Support

Include images in your request using the images field:

• Base64 Format: Set type="base64" with base64-encoded image data
• File Path: Set type="file_path" with path to existing image

Maximum 5 images per request. Invalid images will trigger a 400 response.

Authentication

Requires API key via x-wabee-access header.

Session Management

Use session-id header to maintain conversation context across requests.

Requests Wabee AI Agent to answer a question regarding the mission that the agent was given to upon creation.

The agent can make use of any of the available tools along with its own reasoning to complete the given task, depending on its complexity, the response might take some time to be returned to the user.

Note: session_id field on request body is kept for compatibility purposes, it will be overwritten with the header value during request processing Note: stream filed on request body is kept for compatibility purposes, it will be ignored during request processing Note: this is pretty much the same as in /chain, the only difference is that this endpoint returns a streaming response instead of a JSON object Note: the id on the streamming response refers to the current request Note: the streamming response ends when finish_reason is different than null Note: All headers starting with stix will be sent as context for tools.

Requests Wabee AI Agent to answer a question asynchronously. If a callback_url is provided, the agent will send the response to the given URL.

The agent can make use of any of the available tools along with its own reasoning to complete the given task, depending on its complexity, the response might take some time to be returned to the user.

Note: session_id field on request body is kept for compatibility purposes, it will be overwritten with the header value during request processing Note: stream filed on request body is kept for compatibility purposes, it will be ignored during request processing

Updates the agent configuration dynamically without restarting the service.

This endpoint allows you to:

• Partially update the agent configuration (merges with existing config)
• Update complete configuration sections or individual fields
• Validate configuration before applying (using validate_only=true)
• Automatically trigger agent re-initialization with new config

The provided configuration is merged with the existing configuration, so you only need to specify the fields you want to change. The configuration is written to the mounted volume and the agent is re-initialized.

Important Notes:

• Only specify the fields you want to update - they will be merged with existing config
• Nested objects are deep-merged (e.g., updating llms.primary.model preserves other llm settings)
• The JSON file on the mounted volume will be updated with the merged configuration
• The agent will be re-initialized, which may take a few seconds
• In-flight requests will complete with the old configuration
• New requests will use the updated configuration
• A backup of the previous configuration is automatically created

Example Partial Updates:

Update just the agent description:

{
    "configuration": {
        "description": "Updated agent description"
    },
    "validate_only": false
}

Update a specific LLM model:

{
    "configuration": {
        "llms": {
            "primary": {
                "model": "gpt-4-turbo"
            }
        }
    },
    "validate_only": false
}

Add a new tool to the existing tools list:

{
    "configuration": {
        "tools": [
            {
                "name": "new_tool",
                "config": {...}
            }
        ]
    },
    "validate_only": false
}

In-memory only update (for read-only config files):

{
    "configuration": {
        "max_execution_time": 2000
    },
    "validate_only": false,
    "in_memory_only": true
}

Copies a file artifact generated by the agent to a shared location.

This endpoint:

1. Retrieves the session state using the provided session ID
2. Gets the specified message by its index in the messages array
3. Retrieves the generated_artifacts field from the message response_metadata
4. Copies the file at the specified artifact index to /tmp/share

Returns the path to the copied file or an error if the file cannot be found/copied.

Generates a downloadable link for a file artifact created by the agent.

This endpoint:

1. Retrieves the session state using the provided session ID (from the 'session-id' header)
2. Gets the specified message by its index in the messages array
3. Retrieves the generated_artifacts field from the message response_metadata
4. Generates a presigned URL for the file at the specified artifact index

Returns the presigned URL that can be used to download the file directly.