POST
/
api
/
v1
/
invoke_agent
curl --request POST \
  --url https://api.b-bot.space/api/v1/invoke_agent \
  --header 'Content-Type: application/json' \
  --header 'bbot-api-key: <api-key>' \
  --data '{
  "expert_id": 37,
  "ability_id": 80,
  "model_id": 6,
  "session_id": "12333333",
  "input_data": "use the Assistant Consultation Tool to call an Assistant for help regarding a question",
  "temperature": 0,
  "user_id": "123",
  "document_urls": [
    "<string>"
  ],
  "conversation_history": [
    {
      "role": "<string>",
      "content": "<string>"
    }
  ],
  "tool_config": {
    "tavily_max_results": 1
  },
  "tool_activation": {
    "tavily_search": true,
    "wolfram_alpha": true,
    "document_retriever": false,
    "notion_connector": false
  }
}'
{
  "input": "use the Assistant Consultation Tool to call an Assistant for help regarding a question",
  "chat_history": [
    {
      "role": "<string>",
      "content": "<string>"
    }
  ],
  "output": "### Marketing Strategy Improvement Tips:\n- **Set Objectives Right Away:** Setting clear objectives is crucial...",
  "intermediate_steps": [
    [
      {
        "tool": "<string>",
        "tool_input": {
          "query": "<string>"
        },
        "log": "<string>",
        "message_log": [
          {
            "content": "<string>",
            "additional_kwargs": {
              "tool_calls": [
                {
                  "index": 123,
                  "id": "<string>",
                  "function": {
                    "arguments": "<string>",
                    "name": "<string>"
                  },
                  "type": "<string>"
                }
              ]
            }
          }
        ],
        "tool_call_id": "<string>"
      }
    ]
  ]
}

Ensure that the correct bbot-api-key is included in the request header.

The input_data should be crafted based on the specific use case and the abilities of the agent being invoked.

The tool_config and tool_activation settings should be configured based on the desired tools and functionalities for the agent.

Authorizations

​
bbot-api-key
string
header
required

API key for authentication

Body

application/json
Plant to add to the store
​
expert_id
integer

The ID of the expert you want to invoke.

Example:

37

​
ability_id
integer

The ID of the ability to be used by the agent.

Example:

80

​
model_id
integer

The ID of the language model to be used.

Example:

6

​
session_id
string

The session ID for tracking the interaction.

Example:

"12333333"

​
input_data
string

The input query or command for the agent.

Example:

"use the Assistant Consultation Tool to call an Assistant for help regarding a question"

​
temperature
integer

The temperature the Agent should work on.

Example:

0

​
user_id
string

The ID of the user making the request.

Example:

"123"

​
document_urls
string[]

A list of document URLs to be used by the agent.

​
conversation_history
object[]

A list of previous interactions with the agent.

​
tool_config
object

Configuration options for various tools available to the agent.

​
tool_activation
object

Activation options for various tools.

Response

200
application/json
plant response
​
input
string

The input command for the assistant.

Example:

"use the Assistant Consultation Tool to call an Assistant for help regarding a question"

​
chat_history
object[]

A list of previous chat interactions.

​
output
string

The output generated by the agent.

Example:

"### Marketing Strategy Improvement Tips:\n- **Set Objectives Right Away:** Setting clear objectives is crucial..."

​
intermediate_steps
array

A list of intermediate steps taken by the agent.