servidor openapi-mcp

Servidor de Protocolo de Contexto de Modelo (MCP) para la API de Letta.

Descripción

Este servidor proporciona una interfaz de Protocolo de Contexto de Modelo (MCP) a la API.

Related MCP server: Zero Trust Access AI Agent - MCP Server

Instalación

Instalar dependencias:

npm install

Cree un archivo .env basado en .env.example :

cp .env.example .env

Edite el archivo .env para agregar su configuración de API y detalles de autorización.

Configuración

Las siguientes variables de entorno se pueden configurar en el archivo .env :

API_BASE_URL : URL base para la API (obligatoria)
SERVER_NAME : Nombre del servidor MCP (predeterminado: "openapi-mcp-server")
SERVER_VERSION : Versión del servidor MCP (predeterminado: "1.0.0")
DEBUG : Habilitar el registro de depuración (verdadero/falso) (valor predeterminado: falso)

Uso

Ejecución del servidor

El servidor se proporciona en versiones JavaScript y TypeScript:

# Run JavaScript version npm start # Or run TypeScript version (compiles on the fly) npm run start:ts

Construyendo la versión TypeScript

npm run build cd dist node server.js

Uso como proveedor de herramientas MCP

Este servidor implementa el Protocolo de contexto de modelo (MCP) y se puede utilizar con cualquier consumidor compatible con MCP, como el cliente Claude.js u otros consumidores MCP.

Ejemplo de conexión a este servidor desde un cliente Claude.js:

import { MCP } from "claude-js"; import { createStdio } from "claude-js/mcp"; // Create stdin/stdout transport const transport = createStdio({ command: "node path/to/server.js" }); // Connect to the MCP server const mcp = new MCP({ transport }); await mcp.connect(); // List available tools const { tools } = await mcp.listTools(); console.log("Available tools:", tools); // Call a tool const result = await mcp.callTool({ id: "TOOL-ID", arguments: { param1: "value1" } }); console.log("Tool result:", result);

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas:

herramienta de eliminación

ID : DELETE-v1-tools-tool-id
Descripción : Eliminar una herramienta por nombre
Método : DELETE
Ruta : /v1/tools/{tool_id}

Parámetros :

tool_id : parámetro tool_id (obligatorio)
user_id : parámetro user_id

herramienta de recuperación

ID : GET-v1-tools-tool-id
Descripción : Obtener una herramienta por ID
Método : GET
Ruta : /v1/tools/{tool_id}

Parámetros :

tool_id : parámetro tool_id (obligatorio)
user_id : parámetro user_id

modificar_herramienta

ID : PATCH-v1-tools-tool-id
Descripción : Actualizar una herramienta existente
Método : PATCH
Ruta : /v1/tools/{tool_id}

Parámetros :

tool_id : parámetro tool_id (obligatorio)
user_id : parámetro user_id

lista_de_herramientas

ID : GET-v1-tools-
Descripción : Obtenga una lista de todas las herramientas disponibles para los agentes que pertenecen a la organización del usuario
Método : GET
Ruta : /v1/tools/

Parámetros :

after : después del parámetro
limit : parámetro límite
name : parámetro de nombre
user_id : parámetro user_id

crear_herramienta

ID : POST-v1-tools-
Descripción : Crear una nueva herramienta
Método : POST
Ruta : /v1/tools/

Parámetros :

user_id : parámetro user_id

herramienta upsert

ID : PUT-v1-tools-
Descripción : Crear o actualizar una herramienta
Método : PUT
Ruta : /v1/tools/

Parámetros :

user_id : parámetro user_id

agregar_herramientas_base

ID : POST-v1-tools-add-base-tools
Descripción : Herramientas de base de inserción y actualización
Método : POST
Ruta : /v1/tools/add-base-tools

Parámetros :

user_id : parámetro user_id

ejecutar_herramienta_desde_la_fuente

ID : POST-v1-tools-run
Descripción : Intenta crear una herramienta desde la fuente y luego ejecútala con los argumentos proporcionados.
Método : POST
Ruta : /v1/tools/run

Parámetros :

user_id : parámetro user_id

lista_composición_aplicaciones

ID : GET-v1-tools-composio-apps
Descripción : Obtenga una lista de todas las aplicaciones de Composio
Método : GET
Ruta : /v1/tools/composio/apps

Parámetros :

user-id : parámetro de identificación del usuario

lista_composición_acciones_por_aplicación

ID : GET-v1-tools-composio-apps-composio-app-name-actions
Descripción : Obtenga una lista de todas las acciones de Composio para una aplicación específica
Método : GET
Ruta : /v1/tools/composio/apps/{composio_app_name}/actions

Parámetros :

composio_app_name : parámetro composio_app_name (obligatorio)
user_id : parámetro user_id

herramienta para agregar composición

ID : POST-v1-tools-composio-composio-action-name
Descripción : Agrega una nueva herramienta de Composio por nombre de acción (Composio se refiere a cada herramienta como una Action )
Método : POST
Ruta : /v1/tools/composio/{composio_action_name}

Parámetros :

composio_action_name : parámetro composio_action_name (obligatorio)
user_id : parámetro user_id

lista_servidores_mcp

ID : GET-v1-tools-mcp-servers
Descripción : Obtenga una lista de todos los servidores MCP configurados
Método : GET
Ruta : /v1/tools/mcp/servers

Parámetros :

user-id : parámetro de identificación del usuario

agregar_servidor_mcp

ID : PUT-v1-tools-mcp-servers
Descripción : Agregue un nuevo servidor MCP a la configuración del servidor MCP de Letta
Método : PUT
Ruta : /v1/tools/mcp/servers

Parámetros :

user_id : parámetro user_id

lista_de_herramientas_mcp_por_servidor

ID : GET-v1-tools-mcp-servers-mcp-server-name-tools
Descripción : Obtenga una lista de todas las herramientas para un servidor MCP específico
Método : GET
Ruta : /v1/tools/mcp/servers/{mcp_server_name}/tools

Parámetros :

mcp_server_name : parámetro mcp_server_name (obligatorio)
user_id : parámetro user_id

agregar_herramienta_mcp

ID : POST-v1-tools-mcp-servers-mcp-server-name-mcp-tool-name
Descripción : Registrar una nueva herramienta MCP como servidor Letta mediante el servidor MCP + nombre de la herramienta
Método : POST
Ruta : /v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}

Parámetros :

mcp_server_name : parámetro mcp_server_name (obligatorio)
mcp_tool_name : parámetro mcp_tool_name (obligatorio)
user_id : parámetro user_id

eliminar_servidor_mcp

ID : DELETE-v1-tools-mcp-servers-mcp-server-name
Descripción : Agregue un nuevo servidor MCP a la configuración del servidor MCP de Letta
Método : DELETE
Ruta : /v1/tools/mcp/servers/{mcp_server_name}

Parámetros :

mcp_server_name : parámetro mcp_server_name (obligatorio)
user_id : parámetro user_id

recuperar_fuente

ID : GET-v1-sources-source-id
Descripción : Obtenga todas las fuentes
Método : GET
Ruta : /v1/sources/{source_id}

Parámetros :

source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

modificar_fuente

ID : PATCH-v1-sources-source-id
Descripción : Actualiza el nombre o la documentación de una fuente de datos existente.
Método : PATCH
Ruta : /v1/sources/{source_id}

Parámetros :

source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

eliminar_fuente

ID : DELETE-v1-sources-source-id
Descripción : Eliminar una fuente de datos.
Método : DELETE
Ruta : /v1/sources/{source_id}

Parámetros :

source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

obtener_id_de_origen_por_nombre

ID : GET-v1-sources-name-source-name
Descripción : Obtener una fuente por nombre
Método : GET
Ruta : /v1/sources/name/{source_name}

Parámetros :

source_name : parámetro source_name (obligatorio)
user_id : parámetro user_id

lista_fuentes

ID : GET-v1-sources-
Descripción : Enumera todas las fuentes de datos creadas por un usuario.
Método : GET
Ruta : /v1/sources/

Parámetros :

user_id : parámetro user_id

crear_fuente

ID : POST-v1-sources-
Descripción : Crea una nueva fuente de datos.
Método : POST
Ruta : /v1/sources/

Parámetros :

user_id : parámetro user_id

subir_archivo_a_la_fuente

ID : POST-v1-sources-source-id-upload
Descripción : Sube un archivo a una fuente de datos.
Método : POST
Ruta : /v1/sources/{source_id}/upload

Parámetros :

source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

lista_de_pasajes_fuente

ID : GET-v1-sources-source-id-passages
Descripción : Enumera todos los pasajes asociados con una fuente de datos.
Método : GET
Ruta : /v1/sources/{source_id}/passages

Parámetros :

source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

lista_de_archivos_fuente

ID : GET-v1-sources-source-id-files
Descripción : Lista de archivos paginados asociados con una fuente de datos.
Método : GET
Ruta : /v1/sources/{source_id}/files

Parámetros :

source_id : parámetro source_id (obligatorio)
limit : Número de archivos a devolver
after : Cursor de paginación para obtener el siguiente conjunto de resultados
user_id : parámetro user_id

eliminar_archivo_del_origen

ID : DELETE-v1-sources-source-id-file-id
Descripción : Eliminar una fuente de datos.
Método : DELETE
Ruta : /v1/sources/{source_id}/{file_id}

Parámetros :

source_id : parámetro source_id (obligatorio)
file_id : parámetro file_id (obligatorio)
user_id : parámetro user_id

lista_agentes

ID : GET-v1-agents-
Descripción : enumera todos los agentes asociados con un usuario determinado.

Este punto final recupera una lista de todos los agentes y sus configuraciones asociadas con el ID de usuario especificado.

Método : GET
Ruta : /v1/agents/

Parámetros :

name : Nombre del agente
tags : Lista de etiquetas para filtrar agentes
match_all_tags : Si es verdadero, solo se devuelven los agentes que coinciden con todas las etiquetas proporcionadas. De lo contrario, se devuelven los agentes que tengan cualquiera de las etiquetas proporcionadas.
before : Cursor para paginación
after : Cursor para paginación
limit : Límite de paginación
query_text : Buscar agentes por nombre
project_id : Buscar agentes por ID de proyecto
template_id : Buscar agentes por ID de plantilla
base_template_id : Buscar agentes por ID de plantilla base
identity_id : Buscar agentes por ID de identidad
identifier_keys : Buscar agentes por claves de identificador
include_relationships : Especifique los campos relacionales (p. ej., "herramientas", "fuentes", "memoria") que se incluirán en la respuesta. Si no se proporciona, se cargan todas las relaciones por defecto. Usar esto puede optimizar el rendimiento al reducir las uniones innecesarias.
ascending : si se deben ordenar los agentes del más antiguo al más nuevo (Verdadero) o del más nuevo al más antiguo (Falso, predeterminado)
user_id : parámetro user_id

crear_agente

ID : POST-v1-agents-
Descripción : Crea un nuevo agente con la configuración especificada.
Método : POST
Ruta : /v1/agents/

Parámetros :

user_id : parámetro user_id
X-Project : parámetro del Proyecto X

agente de exportación serializado

ID : GET-v1-agents-agent-id-export
Descripción : Exporta la representación JSON serializada de un agente.
Método : GET
Ruta : /v1/agents/{agent_id}/export

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

agente de importación serializado

ID : POST-v1-agents-import
Descripción : Importa un archivo de agente serializado y recrea el agente en el sistema.
Método : POST
Ruta : /v1/agents/import

Parámetros :

append_copy_suffix : si se establece en Verdadero, agrega "_copy" al final del nombre del agente.
override_existing_tools : Si se establece en Verdadero, las definiciones de herramientas cargadas pueden sobrescribir el código fuente de las herramientas existentes. Tenga en cuenta que las herramientas principales de Letta nunca se pueden actualizar externamente.
project_id : El ID del proyecto con el que se asociará el agente cargado.
user_id : parámetro user_id

ventana de contexto del agente de recuperación

ID : GET-v1-agents-agent-id-context
Descripción : Recupera la ventana de contexto de un agente específico.
Método : GET
Ruta : /v1/agents/{agent_id}/context

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

modificar_agente

ID : PATCH-v1-agents-agent-id
Descripción : Actualizar un agente existente
Método : PATCH
Ruta : /v1/agents/{agent_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

agente de recuperación

ID : GET-v1-agents-agent-id
Descripción : Obtener el estado del agente.
Método : GET
Ruta : /v1/agents/{agent_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

agente de eliminación

ID : DELETE-v1-agents-agent-id
Descripción : Eliminar un agente.
Método : DELETE
Ruta : /v1/agents/{agent_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

herramientas del agente de lista

ID : GET-v1-agents-agent-id-tools
Descripción : Obtener herramientas de un agente existente
Método : GET
Ruta : /v1/agents/{agent_id}/tools

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

adjuntar_herramienta

ID : PATCH-v1-agents-agent-id-tools-attach-tool-id
Descripción : Adjunta una herramienta a un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/tools/attach/{tool_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
tool_id : parámetro tool_id (obligatorio)
user_id : parámetro user_id

herramienta de separación

ID : PATCH-v1-agents-agent-id-tools-detach-tool-id
Descripción : Separar una herramienta de un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/tools/detach/{tool_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
tool_id : parámetro tool_id (obligatorio)
user_id : parámetro user_id

adjuntar_fuente_al_agente

ID : PATCH-v1-agents-agent-id-sources-attach-source-id
Descripción : Adjunta una fuente a un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/sources/attach/{source_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

separar_la_fuente_del_agente

ID : PATCH-v1-agents-agent-id-sources-detach-source-id
Descripción : Separar una fuente de un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/sources/detach/{source_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
source_id : parámetro source_id (obligatorio)
user_id : parámetro user_id

lista_de_fuentes_del_agente

ID : GET-v1-agents-agent-id-sources
Descripción : Obtener las fuentes asociadas con un agente.
Método : GET
Ruta : /v1/agents/{agent_id}/sources

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

recuperar_memoria_del_agente

ID : GET-v1-agents-agent-id-core-memory
Descripción : Recupera el estado de memoria de un agente específico. Este endpoint obtiene el estado de memoria actual del agente identificado por el ID de usuario y el ID de agente.
Método : GET
Ruta : /v1/agents/{agent_id}/core-memory

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

recuperar_bloque_de_memoria_central

ID : GET-v1-agents-agent-id-core-memory-blocks-block-label
Descripción : Recupera un bloque de memoria central de un agente.
Método : GET
Ruta : /v1/agents/{agent_id}/core-memory/blocks/{block_label}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
block_label : parámetro block_label (obligatorio)
user_id : parámetro user_id

modificar_bloque_de_memoria_del_núcleo

ID : PATCH-v1-agents-agent-id-core-memory-blocks-block-label
Descripción : Actualiza un bloque de memoria central de un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/core-memory/blocks/{block_label}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
block_label : parámetro block_label (obligatorio)
user_id : parámetro user_id

lista_de_bloques_de_memoria_central

ID : GET-v1-agents-agent-id-core-memory-blocks
Descripción : Recupera los bloques de memoria centrales de un agente específico.
Método : GET
Ruta : /v1/agents/{agent_id}/core-memory/blocks

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

adjuntar_bloque_de_memoria_central

ID : PATCH-v1-agents-agent-id-core-memory-blocks-attach-block-id
Descripción : Adjunta un bloque de memoria central a un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
block_id : parámetro block_id (obligatorio)
user_id : parámetro user_id

separar_bloque_de_memoria_del_núcleo

ID : PATCH-v1-agents-agent-id-core-memory-blocks-detach-block-id
Descripción : Separar un bloque de memoria central de un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
block_id : parámetro block_id (obligatorio)
user_id : parámetro user_id

lista_de_pasajes

ID : GET-v1-agents-agent-id-archival-memory
Descripción : Recupera las memorias en el almacén de memoria de archivo de un agente (consulta paginada).
Método : GET
Ruta : /v1/agents/{agent_id}/archival-memory

Parámetros :

agent_id : parámetro agent_id (obligatorio)
after : ID único de la memoria donde iniciar el rango de consulta.
before : ID único de la memoria donde finalizar el rango de consulta.
limit : cuántos resultados incluir en la respuesta.
search : Buscar pasajes por texto
ascending : si se deben ordenar los pasajes del más antiguo al más nuevo (Verdadero, predeterminado) o del más nuevo al más antiguo (Falso)
user_id : parámetro user_id

crear_pasaje

ID : POST-v1-agents-agent-id-archival-memory
Descripción : Inserta una memoria en el almacén de memoria de archivo de un agente.
Método : POST
Ruta : /v1/agents/{agent_id}/archival-memory

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

modificar_pasaje

ID : PATCH-v1-agents-agent-id-archival-memory-memory-id
Descripción : Modifica una memoria en el almacén de memoria de archivo del agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/archival-memory/{memory_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
memory_id : parámetro memory_id (obligatorio)
user_id : parámetro user_id

eliminar_pasaje

ID : DELETE-v1-agents-agent-id-archival-memory-memory-id
Descripción : Elimina una memoria del almacén de memoria de archivo de un agente.
Método : DELETE
Ruta : /v1/agents/{agent_id}/archival-memory/{memory_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
memory_id : parámetro memory_id (obligatorio)
user_id : parámetro user_id

lista_de_mensajes

ID : GET-v1-agents-agent-id-messages
Descripción : Recupera el historial de mensajes de un agente.
Método : GET
Ruta : /v1/agents/{agent_id}/messages

Parámetros :

agent_id : parámetro agent_id (obligatorio)
after : Mensaje después del cual se recuperarán los mensajes devueltos.
before : Mensaje antes del cual se recuperarán los mensajes devueltos.
limit : Número máximo de mensajes a recuperar.
use_assistant_message : Si se deben utilizar mensajes del asistente
assistant_message_tool_name : El nombre de la herramienta de mensaje designada.
assistant_message_tool_kwarg : El nombre del argumento del mensaje.
user_id : parámetro user_id

enviar_mensaje

ID : POST-v1-agents-agent-id-messages
Descripción : Procesa un mensaje de usuario y devuelve la respuesta del agente. Este punto final acepta un mensaje de usuario y lo procesa a través del agente.
Método : POST
Ruta : /v1/agents/{agent_id}/messages

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

modificar_mensaje

ID : PATCH-v1-agents-agent-id-messages-message-id
Descripción : Actualiza los detalles de un mensaje asociado a un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/messages/{message_id}

Parámetros :

agent_id : parámetro agent_id (obligatorio)
message_id : parámetro message_id (obligatorio)
user_id : parámetro user_id

crear_flujo_de_mensajes_del_agente

ID : POST-v1-agents-agent-id-messages-stream
Descripción : Procesa un mensaje de usuario y devuelve la respuesta del agente. Este endpoint acepta un mensaje de usuario y lo procesa a través del agente. Siempre transmitirá los pasos de la respuesta y los tokens si 'stream_tokens' está configurado como Verdadero.
Método : POST
Ruta : /v1/agents/{agent_id}/messages/stream

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

crear_mensaje_de_agente_asincrónico

ID : POST-v1-agents-agent-id-messages-async
Descripción : Procesa asincrónicamente un mensaje de usuario y devuelve un objeto de ejecución. El procesamiento se realiza en segundo plano y el estado se puede consultar mediante el ID de ejecución.
Método : POST
Ruta : /v1/agents/{agent_id}/messages/async

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

mensajes de reinicio

ID : PATCH-v1-agents-agent-id-reset-messages
Descripción : Restablece los mensajes de un agente.
Método : PATCH
Ruta : /v1/agents/{agent_id}/reset-messages

Parámetros :

agent_id : parámetro agent_id (obligatorio)
add_default_initial_messages : si es verdadero, agrega los mensajes iniciales predeterminados después de restablecer.
user_id : parámetro user_id

crear_grupo

ID : POST-v1-groups-
Descripción : Crea un nuevo grupo multiagente con la configuración especificada.
Método : POST
Ruta : /v1/groups/

Parámetros :

user_id : parámetro user_id
X-Project : parámetro del Proyecto X

grupos de listas

ID : GET-v1-groups-
Descripción : Obtiene todos los grupos multiagente que coinciden con la consulta.
Método : GET
Ruta : /v1/groups/

Parámetros :

manager_type : Buscar grupos por tipo de administrador
before : Cursor para paginación
after : Cursor para paginación
limit : Límite de paginación
project_id : Buscar grupos por id de proyecto
user_id : parámetro user_id

upsert_group

ID : PUT-v1-groups-
Descripción : Crea un nuevo grupo multiagente con la configuración especificada.
Método : PUT
Ruta : /v1/groups/

Parámetros :

user_id : parámetro user_id
X-Project : parámetro del Proyecto X

eliminar_grupo

ID : DELETE-v1-groups-group-id
Descripción : Eliminar un grupo de múltiples agentes.
Método : DELETE
Ruta : /v1/groups/{group_id}

Parámetros :

group_id : parámetro group_id (obligatorio)
user_id : parámetro user_id

enviar mensaje grupal

ID : POST-v1-groups-group-id-messages
Descripción : Procesa un mensaje de usuario y devuelve la respuesta del grupo. Este punto final acepta un mensaje de un usuario y lo procesa a través de los agentes del grupo según el patrón especificado.
Método : POST
Ruta : /v1/groups/{group_id}/messages

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user_id : parámetro user_id

lista_de_mensajes_de_grupo

ID : GET-v1-groups-group-id-messages
Descripción : Recupera el historial de mensajes de un agente.
Método : GET
Ruta : /v1/groups/{group_id}/messages

Parámetros :

group_id : parámetro group_id (obligatorio)
after : Mensaje después del cual se recuperarán los mensajes devueltos.
before : Mensaje antes del cual se recuperarán los mensajes devueltos.
limit : Número máximo de mensajes a recuperar.
use_assistant_message : Si se deben utilizar mensajes del asistente
assistant_message_tool_name : El nombre de la herramienta de mensaje designada.
assistant_message_tool_kwarg : El nombre del argumento del mensaje.
user_id : parámetro user_id

enviar mensajes grupales en streaming

ID : POST-v1-groups-group-id-messages-stream
Descripción : Procesa un mensaje de usuario y devuelve las respuestas del grupo. Este endpoint acepta un mensaje de un usuario y lo procesa a través de los agentes del grupo según el patrón especificado. Siempre transmitirá los pasos de la respuesta y los tokens si 'stream_tokens' se establece en Verdadero.
Método : POST
Ruta : /v1/groups/{group_id}/messages/stream

Parámetros :

group_id : parámetro group_id (obligatorio)
user_id : parámetro user_id

lista_identidades

ID : GET-v1-identities-
Descripción : Obtener una lista de todas las identidades en la base de datos
Método : GET
Ruta : /v1/identities/

Parámetros :

name : parámetro de nombre
project_id : parámetro project_id
identifier_key : parámetro clave_identificadora
identity_type : parámetro de tipo de identidad
before : antes del parámetro
after : después del parámetro
limit : parámetro límite
user_id : parámetro user_id

crear_identidad

ID : POST-v1-identities-
Descripción : Realizar una solicitud POST a /v1/identities/
Método : POST
Ruta : /v1/identities/

Parámetros :

user_id : parámetro user_id
X-Project : parámetro del Proyecto X

upsert_identity

ID : PUT-v1-identities-
Descripción : Realizar una solicitud PUT a /v1/identities/
Método : PUT
Ruta : /v1/identities/

Parámetros :

user_id : parámetro user_id
X-Project : parámetro del Proyecto X

recuperar_identidad

ID : GET-v1-identities-identity-id
Descripción : Realizar una solicitud GET a /v1/identities/{identity_id}
Método : GET
Ruta : /v1/identities/{identity_id}

Parámetros :

identity_id : parámetro identity_id (obligatorio)
user_id : parámetro user_id

actualizar_identidad

ID : PATCH-v1-identities-identity-id
Descripción : Realizar una solicitud PATCH a /v1/identities/{identity_id}
Método : PATCH
Ruta : /v1/identities/{identity_id}

Parámetros :

identity_id : parámetro identity_id (obligatorio)
user_id : parámetro user_id

eliminar_identidad

ID : DELETE-v1-identities-identity-id
Descripción : Eliminar una identidad por su clave identificadora
Método : DELETE
Ruta : /v1/identities/{identity_id}

Parámetros :

identity_id : parámetro identity_id (obligatorio)
user_id : parámetro user_id

lista_modelos

ID : GET-v1-models-
Descripción : Realizar una solicitud GET a /v1/models/
Método : GET
Ruta : /v1/models/

No se requieren parámetros.

lista_modelos_de_incrustación

ID : GET-v1-models-embedding
Descripción : Realizar una solicitud GET a /v1/models/embedding
Método : GET
Ruta : /v1/models/embedding

No se requieren parámetros.

bloques_de_lista

ID : GET-v1-blocks-
Descripción : Realizar una solicitud GET a /v1/blocks/
Método : GET
Ruta : /v1/blocks/

Parámetros :

label : Etiquetas para incluir (por ejemplo, humano, persona)
templates_only : Si se deben incluir solo plantillas
name : Nombre del bloque
identity_id : Buscar agentes por id de identificador
identifier_keys : Buscar agentes por claves de identificador
user_id : parámetro user_id

crear_bloque

ID : POST-v1-blocks-
Descripción : Realizar una solicitud POST a /v1/blocks/
Método : POST
Ruta : /v1/blocks/

Parámetros :

user_id : parámetro user_id

modificar_bloque

ID : PATCH-v1-blocks-block-id
Descripción : Realizar una solicitud PATCH a /v1/blocks/{block_id}
Método : PATCH
Ruta : /v1/blocks/{block_id}

Parámetros :

block_id : parámetro block_id (obligatorio)
user_id : parámetro user_id

eliminar_bloque

ID : DELETE-v1-blocks-block-id
Descripción : Realizar una solicitud DELETE a /v1/blocks/{block_id}
Método : DELETE
Ruta : /v1/blocks/{block_id}

Parámetros :

block_id : parámetro block_id (obligatorio)
user_id : parámetro user_id

recuperar_bloque

ID : GET-v1-blocks-block-id
Descripción : Realizar una solicitud GET a /v1/blocks/{block_id}
Método : GET
Ruta : /v1/blocks/{block_id}

Parámetros :

block_id : parámetro block_id (obligatorio)
user_id : parámetro user_id

lista_de_agentes_para_bloque

ID : GET-v1-blocks-block-id-agents
Descripción : Recupera todos los agentes asociados al bloque especificado. Genera un error 404 si el bloque no existe.
Método : GET
Ruta : /v1/blocks/{block_id}/agents

Parámetros :

block_id : parámetro block_id (obligatorio)
user_id : parámetro user_id

lista_de_trabajos

ID : GET-v1-jobs-
Descripción : Lista todos los trabajos.
Método : GET
Ruta : /v1/jobs/

Parámetros :

source_id : enumera únicamente los trabajos asociados con la fuente.
user_id : parámetro user_id

lista_de_trabajos_activos

ID : GET-v1-jobs-active
Descripción : Lista todos los trabajos activos.
Método : GET
Ruta : /v1/jobs/active

Parámetros :

user_id : parámetro user_id

recuperar_trabajo

ID : GET-v1-jobs-job-id
Descripción : Obtener el estado de un trabajo.
Método : GET
Ruta : /v1/jobs/{job_id}

Parámetros :

job_id : parámetro job_id (obligatorio)
user_id : parámetro user_id

eliminar_trabajo

ID : DELETE-v1-jobs-job-id
Descripción : Eliminar un trabajo por su job_id.
Método : DELETE
Ruta : /v1/jobs/{job_id}

Parámetros :

job_id : parámetro job_id (obligatorio)
user_id : parámetro user_id

chequeo de salud

ID : GET-v1-health-
Descripción : Realizar una solicitud GET a /v1/health/
Método : GET
Ruta : /v1/health/

No se requieren parámetros.

crear_sandbox_config_v1_sandbox_config__post

ID : POST-v1-sandbox-config-
Descripción : Realizar una solicitud POST a /v1/sandbox-config/
Método : POST
Ruta : /v1/sandbox-config/

Parámetros :

user-id : parámetro de identificación del usuario

lista_configuraciones_de_sandbox_v1_configuración_de_sandbox__obtener

ID : GET-v1-sandbox-config-
Descripción : Realizar una solicitud GET a /v1/sandbox-config/
Método : GET
Ruta : /v1/sandbox-config/

Parámetros :

limit : Número de resultados a devolver
after : Cursor de paginación para obtener el siguiente conjunto de resultados
sandbox_type : Filtro para este tipo de sandbox específico
user-id : parámetro de identificación del usuario

crear_configuración_de_sandbox_e2b_predeterminada_v1_configuración_de_sandbox_e2b_predeterminada_publicación

Identificación : POST-v1-sandbox-config-e2b-default
Descripción : Realizar una solicitud POST a /v1/sandbox-config/e2b/default
Método : POST
Ruta : /v1/sandbox-config/e2b/default

Parámetros :

user-id : parámetro de identificación del usuario

crear_configuración_de_sandbox_local_predeterminada_v1_configuración_de_sandbox_local_predeterminada_publicación

ID : POST-v1-sandbox-config-local-default
Descripción : Realizar una solicitud POST a /v1/sandbox-config/local/default
Método : POST
Ruta : /v1/sandbox-config/local/default

Parámetros :

user-id : parámetro de identificación del usuario

crear_configuración_de_sandbox_local_personalizada_v1_configuración_de_sandbox_local_post

ID : POST-v1-sandbox-config-local
Descripción : Crea o actualiza un LocalSandboxConfig personalizado, incluidos pip_requirements.
Método : POST
Ruta : /v1/sandbox-config/local

Parámetros :

user-id : parámetro de identificación del usuario

actualización_sandbox_config_v1_sandbox_config__sandbox_config_id__patch

ID : PATCH-v1-sandbox-config-sandbox-config-id
Descripción : Realizar una solicitud PATCH a /v1/sandbox-config/{sandbox_config_id}
Método : PATCH
Ruta : /v1/sandbox-config/{sandbox_config_id}

Parámetros :

sandbox_config_id : parámetro sandbox_config_id (obligatorio)
user-id : parámetro de identificación del usuario

eliminar_sandbox_config_v1_sandbox_config__sandbox_config_id__eliminar

ID : DELETE-v1-sandbox-config-sandbox-config-id
Descripción : Realizar una solicitud DELETE a /v1/sandbox-config/{sandbox_config_id}
Método : DELETE
Ruta : /v1/sandbox-config/{sandbox_config_id}

Parámetros :

sandbox_config_id : parámetro sandbox_config_id (obligatorio)
user-id : parámetro de identificación del usuario

forzar_recrear_sandbox_local_venv_v1_sandbox_config_local_recrear_venv_post

ID : POST-v1-sandbox-config-local-recreate-venv
Descripción : Recreación forzada del entorno virtual para el entorno de pruebas local. Elimina y recrea el venv, y luego reinstala las dependencias necesarias.
Método : POST
Ruta : /v1/sandbox-config/local/recreate-venv

Parámetros :

user-id : parámetro de identificación del usuario

crear_sandbox_env_var_v1_sandbox_config__sandbox_config_id__variable_de_entorno_post

ID : POST-v1-sandbox-config-sandbox-config-id-environment-variable
Descripción : Realizar una solicitud POST a /v1/sandbox-config/{sandbox_config_id}/environment-variable
Método : POST
Ruta : /v1/sandbox-config/{sandbox_config_id}/environment-variable

Parámetros :

sandbox_config_id : parámetro sandbox_config_id (obligatorio)
user-id : parámetro de identificación del usuario

lista_sandbox_env_vars_v1_sandbox_config__sandbox_config_id__obtención_variable_de_entorno

ID : GET-v1-sandbox-config-sandbox-config-id-environment-variable
Descripción : Realice una solicitud GET a /v1/sandbox-config/{sandbox_config_id}/environment-variable
Método : GET
Ruta : /v1/sandbox-config/{sandbox_config_id}/environment-variable

Parámetros :

sandbox_config_id : parámetro sandbox_config_id (obligatorio)
limit : Número de resultados a devolver
after : Cursor de paginación para obtener el siguiente conjunto de resultados
user-id : parámetro de identificación del usuario

actualización_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__patch

ID : PATCH-v1-sandbox-config-environment-variable-env-var-id
Descripción : Realizar una solicitud PATCH a /v1/sandbox-config/environment-variable/{env_var_id}
Método : PATCH
Ruta : /v1/sandbox-config/environment-variable/{env_var_id}

Parámetros :

env_var_id : parámetro env_var_id (obligatorio)
user-id : parámetro de identificación del usuario

eliminar_sandbox_env_var_v1_sandbox_config_environment_variable__env_var_id__delete

ID : DELETE-v1-sandbox-config-environment-variable-env-var-id
Descripción : Realizar una solicitud DELETE a /v1/sandbox-config/environment-variable/{env_var_id}
Método : DELETE
Ruta : /v1/sandbox-config/environment-variable/{env_var_id}

Parámetros :

env_var_id : parámetro env_var_id (obligatorio)
user-id : parámetro de identificación del usuario

lista_proveedores

ID : GET-v1-providers-
Descripción : Obtenga una lista de todos los proveedores personalizados en la base de datos
Método : GET
Ruta : /v1/providers/

Parámetros :

after : después del parámetro
limit : parámetro límite
user_id : parámetro user_id

crear_proveedor

ID : POST-v1-providers-
Descripción : Crear un nuevo proveedor personalizado
Método : POST
Ruta : /v1/providers/

Parámetros :

user_id : parámetro user_id

modificar_proveedor

ID : PATCH-v1-providers-
Descripción : Actualizar un proveedor personalizado existente
Método : PATCH
Ruta : /v1/providers/

Parámetros :

user_id : parámetro user_id

eliminar_proveedor

ID : DELETE-v1-providers-
Descripción : Eliminar un proveedor personalizado existente
Método : DELETE
Ruta : /v1/providers/

Parámetros :

provider_id : La clave provider_id que se eliminará. (obligatorio)
user_id : parámetro user_id

lista_ejecuciones

ID : GET-v1-runs-
Descripción : Lista todas las ejecuciones.
Método : GET
Ruta : /v1/runs/

Parámetros :

user_id : parámetro user_id

lista_ejecuciones_activas

ID : GET-v1-runs-active
Descripción : Enumera todas las ejecuciones activas.
Método : GET
Ruta : /v1/runs/active

Parámetros :

user_id : parámetro user_id

recuperar_ejecución

ID : GET-v1-runs-run-id
Descripción : Obtener el estado de una ejecución.
Método : GET
Ruta : /v1/runs/{run_id}

Parámetros :

run_id : parámetro run_id (obligatorio)
user_id : parámetro user_id

eliminar_ejecución

ID : DELETE-v1-runs-run-id
Descripción : Elimina una ejecución por su run_id.
Método : DELETE
Ruta : /v1/runs/{run_id}

Parámetros :

run_id : parámetro run_id (obligatorio)
user_id : parámetro user_id

lista_de_mensajes_ejecutados

ID : GET-v1-runs-run-id-messages
Descripción : Obtener mensajes asociados a una ejecución con opciones de filtrado.

Args: run_id: ID de la ejecución before: Un cursor para usar en la paginación. before es un ID de objeto que define su lugar en la lista. Por ejemplo, si realiza una solicitud de lista y recibe 100 objetos, comenzando con obj_foo, su llamada posterior puede incluir before=obj_foo para obtener la página anterior de la lista. after: Un cursor para usar en la paginación. after es un ID de objeto que define su lugar en la lista. Por ejemplo, si realiza una solicitud de lista y recibe 100 objetos, terminando con obj_foo, su llamada posterior puede incluir after=obj_foo para obtener la página siguiente de la lista. limit: Número máximo de mensajes a devolver order: Orden de clasificación por la marca de tiempo created_at de los objetos. asc para orden ascendente y desc para orden descendente. rol: Filtrar por rol (usuario/asistente/sistema/herramienta) return_message_object: Si se deben devolver objetos Message u objetos LettaMessage user_id: ID del usuario que realiza la solicitud

Devuelve: Una lista de mensajes asociados a la ejecución. El valor predeterminado es List[LettaMessage].

Método : GET
Ruta : /v1/runs/{run_id}/messages

Parámetros :

run_id : parámetro run_id (obligatorio)
before : Cursor para paginación
after : Cursor para paginación
limit : Número máximo de mensajes a devolver
order : Ordena por la marca de tiempo created_at de los objetos. asc para orden ascendente y desc para orden descendente.
role : Filtrar por rol
user_id : parámetro user_id

recuperar_ejecución_uso

ID : GET-v1-runs-run-id-usage
Descripción : Obtener estadísticas de uso para una ejecución.
Método : GET
Ruta : /v1/runs/{run_id}/usage

Parámetros :

run_id : parámetro run_id (obligatorio)
user_id : parámetro user_id

lista_de_pasos_de_ejecución

ID : GET-v1-runs-run-id-steps
Descripción : Obtener mensajes asociados a una ejecución con opciones de filtrado.

Args: run_id: ID de la ejecución before: Un cursor para usar en la paginación. before es un ID de objeto que define su lugar en la lista. Por ejemplo, si realiza una solicitud de lista y recibe 100 objetos, comenzando con obj_foo, su llamada posterior puede incluir before=obj_foo para obtener la página anterior de la lista. after: Un cursor para usar en la paginación. after es un ID de objeto que define su lugar en la lista. Por ejemplo, si realiza una solicitud de lista y recibe 100 objetos, terminando con obj_foo, su llamada posterior puede incluir after=obj_foo para obtener la siguiente página de la lista. limit: Número máximo de pasos para devolver order: Orden de clasificación por la marca de tiempo created_at de los objetos. asc para orden ascendente y desc para orden descendente.

Devuelve: una lista de pasos asociados con la ejecución.

Método : GET
Ruta : /v1/runs/{run_id}/steps

Parámetros :

run_id : parámetro run_id (obligatorio)
before : Cursor para paginación
after : Cursor para paginación
limit : Número máximo de mensajes a devolver
order : Ordena por la marca de tiempo created_at de los objetos. asc para orden ascendente y desc para orden descendente.
user_id : parámetro user_id

lista_pasos

ID : GET-v1-steps
Descripción : Lista de pasos con paginación opcional y filtros de fecha. Las fechas deben proporcionarse en formato ISO 8601 (p. ej., 2025-01-29T15:01:19-08:00).
Método : GET
Ruta : /v1/steps

Parámetros :

before : Devuelve los pasos anteriores a este ID de paso
after : Regresa los pasos después de este ID de paso
limit : Número máximo de pasos para regresar
order : Orden de clasificación (ascendente o descendente)
start_date : Devuelve los pasos posteriores a esta fecha y hora ISO (por ejemplo, "2025-01-29T15:01:19-08:00")
end_date : Devuelve los pasos anteriores a esta fecha y hora ISO (por ejemplo, "2025-01-29T15:01:19-08:00")
model : Filtrar por el nombre del modelo utilizado para el paso
agent_id : Filtrar por el ID del agente que realizó el paso
user_id : parámetro user_id

recuperar_paso

ID : GET-v1-steps-step-id
Descripción : Obtenga un paso por ID.
Método : GET
Ruta : /v1/steps/{step_id}

Parámetros :

step_id : parámetro step_id (obligatorio)
user_id : parámetro user_id

id de transacción del paso de actualización

ID : PATCH-v1-steps-step-id-transaction-transaction-id
Descripción : Actualiza el ID de transacción para un paso.
Método : PATCH
Ruta : /v1/steps/{step_id}/transaction/{transaction_id}

Parámetros :

step_id : parámetro step_id (obligatorio)
transaction_id : parámetro transaction_id (obligatorio)
user_id : parámetro user_id

etiquetas de lista

ID : GET-v1-tags-
Descripción : Obtener una lista de todas las etiquetas en la base de datos
Método : GET
Ruta : /v1/tags/

Parámetros :

after : después del parámetro
limit : parámetro límite
query_text : parámetro de texto de consulta
user_id : parámetro user_id

crear_finalizaciones_de_chat_de_voz

ID : POST-v1-voice-beta-agent-id-chat-completions
Descripción : Realizar una solicitud POST a /v1/voice-beta/{agent_id}/chat/completions
Método : POST
Ruta : /v1/voice-beta/{agent_id}/chat/completions

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user-id : parámetro de identificación del usuario

lista_usuarios

ID : GET-v1-admin-users-
Descripción : Obtener una lista de todos los usuarios en la base de datos
Método : GET
Ruta : /v1/admin/users/

Parámetros :

after : después del parámetro
limit : parámetro límite

crear_usuario

ID : POST-v1-admin-users-
Descripción : Crea un nuevo usuario en la base de datos.
Método : POST
Ruta : /v1/admin/users/

No se requieren parámetros.

actualizar_usuario

ID : PUT-v1-admin-users-
Descripción : Actualizar un usuario en la base de datos
Método : PUT
Ruta : /v1/admin/users/

No se requieren parámetros.

eliminar_usuario

ID : DELETE-v1-admin-users-
Descripción : Realizar una solicitud DELETE a /v1/admin/users/
Método : DELETE
Ruta : /v1/admin/users/

Parámetros :

user_id : La clave user_id que se eliminará. (obligatorio)

lista_orgs

ID : GET-v1-admin-orgs-
Descripción : Obtenga una lista de todas las organizaciones en la base de datos
Método : GET
Ruta : /v1/admin/orgs/

Parámetros :

after : después del parámetro
limit : parámetro límite

crear_organización

ID : POST-v1-admin-orgs-
Descripción : Crea una nueva organización en la base de datos.
Método : POST
Ruta : /v1/admin/orgs/

No se requieren parámetros.

eliminar_organización_por_id

ID : DELETE-v1-admin-orgs-
Descripción : Realizar una solicitud DELETE a /v1/admin/orgs/
Método : DELETE
Ruta : /v1/admin/orgs/

Parámetros :

org_id : La clave org_id que se eliminará. (obligatorio)

actualizar_organización

ID : PATCH-v1-admin-orgs-
Descripción : Realizar una solicitud PATCH a /v1/admin/orgs/
Método : PATCH
Ruta : /v1/admin/orgs/

Parámetros :

org_id : La clave org_id que se actualizará. (obligatorio)

crear_finalizaciones_de_chat

ID : POST-openai-v1-agent-id-chat-completions
Descripción : Realizar una solicitud POST a /openai/v1/{agent_id}/chat/completions
Método : POST
Ruta : /openai/v1/{agent_id}/chat/completions

Parámetros :

agent_id : parámetro agent_id (obligatorio)
user-id : parámetro de identificación del usuario

autenticar_usuario_v1_auth_post

ID : POST-v1-auth
Descripción : Autentica al usuario y envía una respuesta con datos relacionados con el usuario.

Actualmente, este es un marcador de posición que simplemente devuelve un marcador de posición UUID

Método : POST
Ruta : /v1/auth

No se requieren parámetros.

Licencia

Instituto Tecnológico de Massachusetts (MIT)