Saltar al contenido principal

Funcionalidades Principales

Beak AI Studio es la superficie de diseño para todo lo que se ejecuta en Beak AI: agentes, habilidades, prompts, fuentes de datos, credenciales y servidores MCP. Es el lugar donde los constructores definen lo que un agente sabe (fuentes de datos), lo que puede hacer (habilidades y herramientas MCP), cómo debe pensar (prompts y modelos) y dónde se ejecuta (Agent Runtime). Una vez publicados, los agentes quedan disponibles para el AI Runtime y para productos integrados como Beak Desk y Beak ITSM.

El panel de Studio resume el estado del espacio de trabajo: agentes activos, habilidades, fuentes de datos, prompts y servidores MCP, junto con la actividad reciente de los agentes y acciones rápidas para crear nuevos objetos.

Diseño del Espacio de Trabajo​

La navegación izquierda agrupa todos los objetos de AI Studio en cuatro secciones:

  • Build — Agents, Skills, Prompts. Las unidades componibles que define un constructor.
  • Data — Datasources, Credentials, MCP Servers. Las conexiones que un agente utiliza para leer conocimiento, autenticarse en sistemas y llamar a herramientas externas.
  • Test — Playground. Superficie de chat interactivo para cualquier agente en el espacio de trabajo.
  • System — Settings. Conexiones a nivel de espacio de trabajo con el Agent Runtime y el AI Gateway.

Todas las vistas de lista en Studio utilizan las mismas convenciones: cuadro de búsqueda, filtro de estado (Active / Inactive), filtros de tipo/categoría, un botón de acción principal (Create …) y acciones por fila para activar/desactivar, historial y editar.

Agentes​

Los agentes son el punto de entrada para los usuarios. Un agente tiene una identidad (nombre, descripción, ícono, industria), un prompt de sistema, un modelo con temperatura y un conjunto de Skills, Datasources, Sub-Agents (solo orquestadores) y MCP Servers adjuntos. Se admiten dos tipos:

  • Assistant — Agente de propósito único que gestiona una conversación de extremo a extremo usando sus propias habilidades y datos.
  • Orchestrator — Coordinador que delega trabajo a otros agentes publicados (sub-agentes), además de sus propias habilidades.

Consulte Creación de Agentes y Assistant vs Orchestrator para el recorrido completo.

Habilidades​

Las habilidades son las acciones que un agente puede invocar. Una habilidad se registra una vez y se reutiliza en cualquier número de agentes. Se admiten cuatro tipos de habilidades:

  • Prompt-Based Task Execution — Ejecuta una plantilla de prompt con un LLM, analizando opcionalmente la salida como JSON.
  • External API Integration — Llama a cualquier endpoint REST descrito por una especificación OpenAPI.
  • KQL Query Execution — Consulta una fuente de datos usando KQL con un esquema de tabla definido.
  • Code Execution — Ejecuta Python o PowerShell, ya sea generado por IA a partir de una instrucción o un fragmento estático proporcionado por usted.

Cada habilidad define sus entradas (parámetros que el LLM extrae del mensaje del usuario), un mensaje de acción opcional y opciones para Audit, Approval, Requires Authentication e Include Conversation Context. Consulte Creación de Habilidades.

Prompts​

La biblioteca de Prompts almacena plantillas de prompt reutilizables que pueden referenciarse desde agentes y habilidades mediante la pestaña Library. Cada prompt tiene un Type (System, User, Assistant, Template), una lista de etiquetas para organización y contenido versionado escrito en markdown. Consulte Prompts.

Fuentes de Datos​

Las fuentes de datos exponen conocimiento, datos estructurados y datos de aplicaciones SaaS a los agentes a través de una única interfaz de recuperación. AI Studio admite cuatro categorías de fuentes de datos:

  • Database — PostgreSQL, MySQL, SQL Server, MongoDB, Redis, Cassandra, Elasticsearch, OpenSearch, Oracle, Azure Log Analytics.
  • System — ServiceNow, Zendesk, ConnectWise Manage, SentinelOne, Azure DevOps, Microsoft Intune, N-Central, Beak RMM, Atlassian Jira, ManageEngine Endpoint Central, ManageEngine ServiceDesk Plus, Microsoft 365, Microsoft Entra, Beak ITSM, NinjaOne, Plumsail, SolarWinds Service Desk, Zoho Desk.
  • Files — Upload Documents para cargas directas o SharePoint Documents para bibliotecas.
  • Website — Public Website, Web Portal o SharePoint Sites indexados para recuperación.

Consulte Descripción General de Fuentes de Datos.

Credenciales​

Las credenciales son los secretos que un agente utiliza para llamar a sistemas externos. Las categorías incluyen API (API Key, Basic, Bearer, Custom Header), Cloud (AWS IAM, Azure AD Service Principal, Azure OpenAI, OpenAI) y OAuth. Las credenciales se almacenan de forma centralizada y se referencian por nombre desde habilidades, fuentes de datos y servidores MCP — nunca aparecen en las definiciones de agentes ni en el tráfico del chat. Consulte Credenciales.

Servidores MCP​

Beak AI Studio es un cliente del Model Context Protocol. Cualquier servidor compatible con MCP (transporte SSE o Streamable HTTP) puede registrarse una vez y sus herramientas quedar disponibles para los agentes. Studio valida la URL del servidor, descubre las herramientas y permite asignar una credencial predeterminada que los agentes pueden anular. Consulte Servidores MCP.

Playground​

El Playground es el banco de pruebas. Seleccione cualquier agente en el espacio de trabajo, inicie un hilo y converse con él usando el mismo runtime, modelo, habilidades y fuentes de datos que utilizarían los usuarios en producción. Los hilos se conservan por agente, de modo que las iteraciones sobre un prompt de sistema o un cambio de habilidad pueden compararse en paralelo. Consulte Playground.

Configuración​

La configuración del espacio de trabajo configura los dos servicios upstream de los que depende AI Studio:

  • Agent Runtime — URL del runtime (y clave API opcional) para la instancia de Beak AI Runtime que aloja los agentes publicados.
  • AI Gateway — URL del gateway, nombre de proyecto opcional y clave virtual para la instancia de Beak AI Gateway que lista los modelos LLM disponibles.

Ambas conexiones exponen las acciones Test Connection y Validate & Preview Models para verificación antes de guardar.

Páginas Relacionadas​