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.

Instalación

1. Instalar dependencias:

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

3. 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:

Construyendo la versión TypeScript

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:

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)