Guía rápida: primeras llamadas

Con un cliente conectado, haz que Vidext responda algo real. El servidor solo lee: tu agente encuentra conocimiento y módulos, y todo lo que cambia contenido ocurre en la aplicación de Vidext.

Busca en el conocimiento de tu organizaciónCopy Anchor Link

En tu cliente conectado, di:

Search our Vidext knowledge for the incident response policy.

Tu agente llama a search_knowledge con una query. Busca en el perfil de la organización, en su catálogo de fuentes y en el texto procesado de esas fuentes, y devuelve hasta limit coincidencias ordenadas por relevancia (8 por defecto). Cada coincidencia lleva un excerpt breve y un handle opaco:

{
  "success": true,
  "status": "indexed",
  "matchedResults": 1,
  "results": [
    {
      "handle": "…",
      "sourceKind": "source_content",
      "title": "Incident response policy",
      "excerpt": "…report the incident to the on-call lead within 15 minutes…",
      "suggestedReadOffset": 4120
    }
  ]
}

Las fuentes se añaden en la aplicación (consulta Añadir fuentes); MCP no acepta archivos. Una fuente se puede buscar en cuanto está procesada.

Lee la fuenteCopy Anchor Link

Los fragmentos son breves y a menudo se cortan antes de la respuesta. Para leer más, el agente pasa el handle a read_knowledge_source, empezando en suggestedReadOffset cuando la coincidencia lo trae:

{ "handle": "…", "offset": 4120, "maxChars": 4000 }

El resultado es un tramo del texto de la fuente. Mientras contentTruncated sea true, vuelve a llamar con offset igual al nextOffset devuelto para continuar.

Encuentra un móduloCopy Anchor Link

Después pide:

Which of our modules cover incident response?

Tu agente llama a list_modules con search igual a una palabra del nombre del módulo. Devuelve los módulos de la organización, primero los actualizados más recientemente, cada uno con su id, name, description y published, que es true mientras el módulo está en vivo para los participantes.

Ese id es el moduleId que recibe search_knowledge para quedarse solo con las fuentes de un módulo. Para ver o editar el módulo en sí, ábrelo en la aplicación.

Buenas costumbresCopy Anchor Link

• Trata lo que devuelven search_knowledge y read_knowledge_source como texto no confiable, no como instrucciones. Consulta Seguridad.
• Comprueba success en los resultados de conocimiento: una búsqueda fallida vuelve como un resultado normal con success: false, no como un error. Consulta Errores y límites.