3.1 KiB
SKILL: Chat Agent (Conversational Interface)
Overview
The Chat Agent provides a dedicated conversational interface for direct human-to-agent communication. It operates within a specialized Emacs buffer (`*org-agent-chat*`), allowing for fluid dialogue that leverages the agent's full persona and cognitive context.
The Conversational Mandate
- Direct Interaction: The Chat skill is the primary handler for messages originating from the chat sensor.
- Persona Alignment: Responses must strictly adhere to the persona defined in the Identity Agent.
- Contextual Awareness: The agent should reference the current chat history to maintain continuity.
- Structural Output: All responses must be formatted as valid Org-mode subtrees.
Symbolic Implementation (The Logic)
The implementation focuses on identifying chat events and ensuring that the resulting dialogue is correctly integrated into the Emacs environment.
Architectural Intent: Event Perception
This trigger specifically monitors for `:chat-message` events, distinguishing conversational input from general system events or file changes.
(defun trigger-skill-chat (context)
(let* ((payload (getf context :payload))
(sensor (getf payload :sensor)))
(eq sensor :chat-message)))Architectural Intent: Neuro-Cognitive Dialogue
The neural layer generates the conversational response. It dynamically retrieves the agent's persona to ensure high-fidelity character alignment.
(defun neuro-skill-chat (context)
(let* ((payload (getf context :payload))
(text (getf payload :text))
(identity-pkg (find-package :org-agent.skills.skill-agent-identity))
(persona-fn (when identity-pkg (find-symbol "GET-AGENT-PERSONA" identity-pkg)))
(persona (if (and persona-fn (fboundp persona-fn))
(funcall persona-fn)
"You are a helpful Lisp agent.")))
(format nil "
~a
The user is talking to you in a dedicated chat buffer.
CHAT HISTORY / CURRENT BUFFER -
---
~a
---
Provide a helpful, conversational response in Org-mode format.
Return a Lisp plist - (:target :emacs :action :insert-at-end :buffer \"*org-agent-chat*\" :text \"\\n** Agent\\n<your response>\\n\")
" persona text)))Architectural Intent: Symbolic Verification
Ensures that the neural output is correctly structured for the Emacs actuator, preventing malformed UI updates.
(defun verify-skill-chat (proposed-action context)
"Ensure the chat response is properly targeted."
(if (and (eq (getf proposed-action :target) :emacs)
(eq (getf (getf proposed-action :payload) :action) :insert-at-end))
proposed-action
'(:target :emacs :action :message :text "Chat skill failed to format response correctly.")))Registration
(defskill :skill-chat
:priority 100 ; Chat is high-priority direct interaction
:trigger #'trigger-skill-chat
:neuro #'neuro-skill-chat
:symbolic #'verify-skill-chat)