PDOC2 — Configuración Genérica de los Asistentes
1. Identificación
- Código: PDOC2
- Nombre: Configuración Genérica de los Asistentes
- Proyecto: Proyecto de Publicaciones
- Tipo: Documento de configuración
- Nivel: Genérico
- Versión: 1.0
- Estado: Vigente
2. Naturaleza del documento
PDOC2 es el documento que establece la estructura y los criterios generales para configurar asistentes dentro del Proyecto de Publicaciones.
Su contenido es genérico y reutilizable.
No configura un asistente específico ni define el comportamiento particular de un asistente determinado.
Las configuraciones concretas deberán desarrollarse en documentos derivados de PDOC2.
3. Ubicación
Ubicación:
generico/PDOC2
La ubicación corresponde a la documentación general del Proyecto de Publicaciones.
La ubicación no forma parte del identificador PDOC2 y podrá modificarse sin afectar las referencias documentales.
4. Propósito
Establecer el marco general para identificar, organizar, configurar, relacionar, mantener y evolucionar los asistentes que formen parte del Proyecto de Publicaciones.
PDOC2 proporciona una estructura común que permita incorporar diferentes tipos de asistentes sin tener que redefinir la arquitectura general para cada uno.
5. Alcance
PDOC2 aplica a los asistentes incorporados al Proyecto de Publicaciones.
Comprende los criterios generales para:
- identificación;
- configuración;
- propósito;
- alcance;
- función;
- comportamiento;
- dependencias;
- utilización de recursos;
- relación con chats;
- mantenimiento;
- evolución;
- y control de versiones.
No establece el contenido específico de ningún asistente.
6. Concepto de asistente
A efectos del Proyecto de Publicaciones, un asistente es un componente especializado destinado a interactuar con el usuario y desarrollar determinadas funciones dentro de la arquitectura del proyecto.
Un asistente podrá:
- interpretar información;
- utilizar recursos autorizados;
- aplicar criterios definidos en su configuración;
- orientar al usuario;
- desarrollar contenidos;
- analizar información;
- generar propuestas;
- y realizar otras funciones específicas.
Las capacidades concretas de cada asistente deberán definirse en su configuración específica.
7. Configuración del asistente
La configuración de un asistente comprende el conjunto de criterios que determinan su funcionamiento dentro del proyecto.
Según las necesidades del asistente, podrá incluir:
- propósito;
- alcance;
- objetivos;
- función;
- comportamiento;
- principios de actuación;
- gestión del contexto;
- interpretación de información;
- utilización de referencias;
- utilización de recursos;
- comunicación;
- recomendaciones;
- límites;
- dependencias;
- evolución;
- y otros criterios necesarios.
La estructura concreta podrá adaptarse a las características del asistente.
8. Separación entre configuración genérica y específica
PDOC2 establece la estructura genérica para la configuración de asistentes.
Cuando un asistente tenga una función común y reutilizable, podrá desarrollarse una configuración genérica especializada.
Cuando esa configuración deba adaptarse a una organización o implementación determinada, podrá desarrollarse una configuración específica.
La estructura prevista es:
PDOC2
→ configuración genérica de cualquier asistente.
PDOC2A
→ configuración genérica especializada del Asistente para Campañas de Comunicación.
PDOC2AN
→ configuración específica del Asistente para Campañas de Comunicación.
Esta estructura permite reutilizar una configuración común sin confundirla con su aplicación específica.
9. Identificación de los asistentes
Cada asistente deberá disponer de una identificación que permita reconocerlo dentro del proyecto.
La identificación podrá comprender:
- código;
- nombre;
- propósito;
- función;
- tipo;
- nivel;
- versión;
- estado;
- documento de configuración;
- ubicación;
- y dependencias principales.
Los identificadores deberán respetar las convenciones establecidas en PDOC0.
10. Registro en el Catálogo de Recursos
Los asistentes y sus documentos de configuración deberán registrarse en el CAT0 — Catálogo de Recursos cuando corresponda.
El registro podrá incluir:
- código;
- nombre;
- tipo;
- nivel;
- estado;
- versión;
- ubicación;
- naturaleza;
- documento de configuración;
- relaciones;
- dependencias.
El Catálogo de Recursos permite localizar y relacionar los componentes, pero no sustituye la configuración del asistente.
11. Naturaleza de la configuración
La configuración deberá distinguir entre:
Configuración genérica
Criterios reutilizables que pueden aplicarse a diferentes implementaciones.
Configuración genérica especializada
Criterios reutilizables destinados a una función determinada.
Configuración específica
Aplicación de una configuración a una organización, proyecto o implementación determinada.
La clasificación deberá mantenerse coherente con los niveles establecidos en PDOC0.
12. Propósito y función
Toda configuración específica de un asistente deberá establecer claramente:
- para qué existe;
- qué función desempeña;
- qué problema ayuda a resolver;
- qué resultados pretende obtener;
- y cuál es su relación con otros componentes del proyecto.
El propósito y la función no deberán confundirse con el flujo conversacional.
13. Comportamiento
Cuando corresponda, la configuración específica podrá establecer criterios sobre:
- interpretación de las solicitudes;
- comprensión del contexto;
- forma de responder;
- recomendaciones;
- tratamiento de información incompleta;
- manejo de incertidumbre;
- interacción con el usuario;
- y otros aspectos de comportamiento.
Estos criterios deberán desarrollarse en el documento específico correspondiente.
PDOC2 establece solamente el marco para definirlos.
14. Gestión del contexto
Los asistentes podrán utilizar información contextual necesaria para desarrollar su función.
La configuración específica deberá determinar:
- qué contexto puede utilizar;
- cómo debe interpretarlo;
- qué información tiene prioridad;
- qué información requiere verificación;
- y cuáles son sus límites.
El contexto no deberá considerarse automáticamente como una fuente de verdad.
15. Utilización de recursos
Los asistentes podrán utilizar recursos del Proyecto de Publicaciones conforme a las reglas establecidas en su configuración.
Entre ellos podrán encontrarse:
- documentos;
- perfiles organizacionales;
- bases de conocimiento;
- fuentes;
- referencias;
- recursos gráficos;
- publicaciones;
- información proporcionada por el usuario;
- y otros recursos autorizados.
La utilización de un recurso deberá respetar:
- su naturaleza;
- su alcance;
- su nivel de autoridad;
- su versión;
- y las relaciones establecidas.
16. Fuentes y referencias
Cuando un asistente utilice fuentes o referencias, su configuración deberá establecer los criterios correspondientes.
Podrá determinarse:
- qué fuentes tienen prioridad;
- cómo se verifica la información;
- cómo se manejan fuentes contradictorias;
- cuándo debe señalarse incertidumbre;
- y cómo se mantiene la trazabilidad.
La configuración del asistente no convierte automáticamente una fuente en autoridad.
La autoridad de los recursos deberá derivarse de su naturaleza y de las reglas establecidas por el proyecto.
17. Relación con los chats
La configuración del asistente y la configuración del chat son elementos diferentes.
Configuración del asistente
→ determina cómo debe actuar el asistente.
Configuración del chat
→ determina cómo se organiza y funciona el espacio conversacional en el que participa.
Un asistente podrá participar en uno o varios chats, de acuerdo con la arquitectura del proyecto.
La configuración del chat no deberá confundirse con la configuración permanente del asistente.
18. Relación con el conocimiento organizacional
Cuando un asistente utilice información organizacional, podrá utilizar recursos como:
- PDOC1A;
- fuentes institucionales;
- documentación histórica;
- recursos registrados en el Catálogo;
- y otros documentos autorizados.
La información organizacional deberá mantenerse diferenciada de la configuración del asistente.
Por ejemplo:
PDOC1A
→ contiene el Perfil Organizacional Específico.
PDOC2AN
→ define cómo debe configurarse el asistente para una aplicación específica.
El asistente podrá utilizar PDOC1A como recurso de conocimiento, pero PDOC1A no se convierte por ello en parte de la configuración del asistente.
19. Dependencias
Cada configuración específica deberá identificar las dependencias relevantes.
Estas podrán incluir:
- PMAN0;
- PDOC0;
- PDOC2;
- configuraciones genéricas especializadas;
- perfiles organizacionales;
- bases de conocimiento;
- configuraciones de chats;
- fuentes;
- y otros recursos.
Las dependencias deberán utilizar los identificadores correspondientes.
20. Incorporación de nuevos asistentes
Cuando se incorpore un nuevo asistente al proyecto deberá:
- identificarse;
- determinarse su propósito;
- establecerse su función;
- determinarse su nivel;
- establecerse su configuración;
- identificar sus dependencias;
- registrar los recursos que utilizará;
- incorporarse al Catálogo de Recursos;
- establecer su versión inicial;
- y establecer su estado.
La incorporación de un nuevo asistente no deberá modificar automáticamente las configuraciones existentes.
21. Evolución de las configuraciones
Las configuraciones podrán evolucionar mediante nuevas versiones.
Las modificaciones deberán:
- identificarse;
- documentarse;
- revisarse;
- aprobarse cuando corresponda;
- y registrarse mediante control de versiones.
Cuando una modificación afecte una configuración genérica, deberá evaluarse su impacto sobre las configuraciones específicas derivadas.
22. Coherencia entre configuraciones
Las configuraciones de los asistentes deberán mantener coherencia con:
- PMAN0;
- PDOC0;
- PDOC2;
- configuraciones genéricas especializadas;
- configuraciones específicas;
- recursos utilizados;
- y configuraciones de los chats correspondientes.
Una configuración específica no deberá contradecir una regla general superior sin que la modificación haya sido expresamente establecida y aprobada.
23. Control de versiones
Cada configuración deberá identificar como mínimo:
- código;
- nombre;
- versión;
- fecha de actualización;
- estado;
- cambios principales.
Las versiones anteriores deberán conservarse cuando resulte necesario para mantener la trazabilidad.
24. Ubicación y trazabilidad
La ubicación física o de almacenamiento de una configuración deberá registrarse conforme a las convenciones establecidas en PDOC0.
La ubicación no forma parte del identificador.
Si una configuración cambia de ubicación, deberá actualizarse el registro correspondiente sin necesidad de modificar su identificador.
25. Relación con documentos derivados
Los documentos específicos de configuración deberán mantener una relación explícita con PDOC2.
La estructura prevista es:
PDOC2
Configuración Genérica de los Asistentes
│
├── PDOC2A
│ Configuración Genérica del
│ Asistente para Campañas de Comunicación
│ │
│ └── PDOC2AN
│ Configuración Específica del
│ Asistente para Campañas de Comunicación
│
└── Otros asistentes
└── Configuraciones específicas correspondientes
PDOC2 no deberá contener información particular de un asistente concreto.
26. Relación con el Catálogo de Recursos y documentación del proyecto
PDOC2 forma parte de la documentación general del Proyecto de Publicaciones.
Su relación administrativa es:
PMAN0 → metodología general. PDOC0 → configuración general del proyecto. PDOC2 → configuración genérica de los asistentes. PDOC2A → configuración genérica especializada. PDOC2AN → configuración específica.
Los asistentes, chats y recursos relacionados deberán registrarse conforme a las convenciones del proyecto.
27. Dependencias generales
PDOC2 deberá utilizarse conjuntamente con:
- PMAN0 — Manual del Sistema;
- PDOC0 — Configuración del Proyecto de Publicaciones;
- CAT0 — Catálogo de Recursos;
- documentos de configuración genérica especializada;
- documentos de configuración específica;
- configuraciones de chats;
- recursos de conocimiento correspondientes.
28. Regla fundamental
PDOC2 define cómo se organizan y gestionan las configuraciones de los asistentes dentro del Proyecto de Publicaciones.
No define el comportamiento concreto de un asistente.
Las configuraciones derivadas deberán establecer el comportamiento, función, contexto, recursos, límites y demás criterios necesarios para cada asistente.
La estructura general es:
PDOC2
→ configuración genérica de asistentes
PDOC2A
→ configuración genérica especializada
PDOC2AN
→ configuración específica