Crear Herramienta | Nebrija AI | Documentation v15.0

import requests
url = "https://nebrijaai.com/api/v1/tools"
payload = {
    "name": "Consulta Clima API",
    "type": "httpRequest",
    "description": "Herramienta para realizar llamadas HTTP a un servicio externo de clima y obtener el pronóstico actual."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "a3f1c9d2-4b7e-4f8a-9c3d-2e5f7b8a9c1d",
  "name": "Consulta Clima API",
  "type": "httpRequest",
  "description": "Herramienta para realizar llamadas HTTP a un servicio externo de clima y obtener el pronóstico actual.",
  "config": {},
  "payloadSchema": {},
  "messages": {},
  "isLocked": true,
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z"
}

Crea una nueva herramienta que los asistentes pueden invocar durante una llamada. Tipos disponibles:

httpRequest: Llamada HTTP a una URL externa.
function: Función personalizada con schema de parámetros.
transferCall: Transferencia de la llamada a otro número.
handOff: Traspaso a un agente humano.

Crea una nueva herramienta que los asistentes pueden invocar durante una llamada. Tipos disponibles: - **httpRequest**: Llamada HTTP a una URL externa. - **function**: Función personalizada con schema de parámetros. - **transferCall**: Transferencia de la llamada a otro número. - **handOff**: Traspaso a un agente humano.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired

typeenumRequired

Allowed values:

descriptionstringRequired

configobjectOptional

Configuración específica del tipo de herramienta.

payloadSchemaobjectOptional

Esquema JSON de los parámetros que la herramienta recibe.

messagesobjectOptional

Mensajes que el agente pronunciará al usar la herramienta.

Response

Herramienta creada.

idstringformat: "uuid"

namestring

typeenum

Allowed values:

descriptionstring

configobject

payloadSchemaobject

messagesobject

isLockedboolean

createdAtdatetime

updatedAtdatetime