AIAgentElement

AIAgentElement representa un elemento de agente de IA configurable en la escena o aplicación. Proporciona una abstracción para conectarse a diferentes proveedores de IA con personalización de prompts, modelos y memoria.

Ejemplo:

const agent = new AIAgentElement();
scene.add(agent);

aiName: string

El nombre para mostrar o alias de este agente de IA. Se usa para la identificación en interfaces, registros o prompts conversacionales.

Ejemplo:

agent.aiName = "HelperBot";

provider: AIProvider

Especifica el proveedor de servicio de IA que se usará para procesar los prompts. Debe ser uno de los valores admitidos en AIProvider:

• "openai-assistant"
• "openai-completion"
• "azure-ai"
• "ollama"

Ejemplo:

agent.provider = "openai-assistant";

apiKey: string

La clave API utilizada para autenticar con el proveedor seleccionado. Debe mantenerse segura y no exponerse en el cliente en producción.

Ejemplo:

agent.apiKey = "sk-xxxxxxxxxxxxxx";

systemPrompt: string

El prompt del sistema que establece el comportamiento, tono y contexto predeterminados del agente de IA. Se inyecta en cada conversación o solicitud de completion.

Ejemplo:

agent.systemPrompt = "Eres un asistente útil para la gestión de escenas 3D.";

model: string

El identificador del modelo usado por el proveedor seleccionado (por ejemplo, "gpt-4", "claude-3-opus", "gemini-1.5"). Debe coincidir con un nombre de modelo válido admitido por el proveedor elegido.

Ejemplo:

agent.model = "gpt-4";

memory: Persistable | string

Objeto de memoria persistente opcional o identificador de memoria. Permite la retención de contexto a largo plazo en múltiples interacciones con el agente de IA.

Ejemplo:

agent.memory = "ai-helper-memory";