j.foucher
a1e34e6dfa
- ElevenLabsComponent::ForceDisableConversation() — removed ActionName param. Now a pure conversation master-switch with no knowledge of actions. OnReadyForAction is fired by the action flow itself: PendingActionName is set when OnAgentActionRequested is broadcasted, then OnReadyForAction fires either after blend-out (if conversation was disabled) or on the next tick (if not). - Rename bConversationDisabledByAction → bConversationForceDisabled — the old name implied coupling with actions which no longer exists. - Add bPendingStartListening — when StartListening is called before the WebSocket is connected (race between StartConversation and StartListening from InteractionComponent), defer instead of silently failing. Consumed automatically in HandleConnected / ClientStartConversation. Cleared by StopListening / EndConversation. - PerceptionComponent — demote the "perceived N actors but ALL filtered out" warning to Verbose; it's a normal case for civilians surrounded by non-hostile actors, not a misconfiguration. - CLAUDE.md — workflow rule: always describe and request confirmation before code changes. - Martin.uasset — agent config tweaks. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
96 lines
4.8 KiB
Markdown
96 lines
4.8 KiB
Markdown
# PS_AI_Agent — Notes pour Claude
|
|
|
|
## Workflow règles
|
|
|
|
**TOUJOURS demander avant de lancer un changement de code.** Avant d'appeler Edit/Write/sed sur un fichier source :
|
|
1. Expliquer ce qu'on s'apprête à faire (quel fichier, quelle logique, quel impact)
|
|
2. Attendre la confirmation explicite de l'utilisateur
|
|
3. Seulement après → effectuer le changement
|
|
|
|
Cela s'applique à : modifications de code (.cpp/.h), refactors, renames bulk, ajouts de nouvelles fonctions.
|
|
Cela ne s'applique PAS à : lecture de fichiers, recherches, git status/log/diff, builds, questions diagnostiques.
|
|
|
|
Exceptions où on peut agir directement :
|
|
- L'utilisateur dit explicitement "fais-le" / "go" / "lance" / "commit"
|
|
- L'utilisateur demande explicitement un changement précis ("renomme X en Y", "ajoute cette fonction")
|
|
- Annulation / revert demandé par l'utilisateur
|
|
|
|
## Plugins dans ce repo
|
|
|
|
### PS_AI_ConvAgent
|
|
- **Module**: `PS_AI_ConvAgent` / `PS_AI_ConvAgentEditor`
|
|
- **API macro**: `PS_AI_CONVAGENT_API`
|
|
- **Class prefix**: `PS_AI_ConvAgent_` (e.g. `UPS_AI_ConvAgent_PostureComponent`)
|
|
- **ElevenLabs-specific**: suffix `_ElevenLabs` (e.g. `UPS_AI_ConvAgent_ElevenLabsComponent`)
|
|
- **UI display**: `"PS AI ConvAgent"` (categories, DisplayName)
|
|
- **CoreRedirects**: DefaultEngine.ini handles both ElevenLabs* and PS_AI_Agent_* → PS_AI_ConvAgent_*
|
|
|
|
### PS_AI_Behavior
|
|
- **Module**: `PS_AI_Behavior` / `PS_AI_BehaviorEditor`
|
|
- **API macro**: `PS_AI_BEHAVIOR_API`
|
|
- **Class prefix**: `PS_AI_Behavior_` (e.g. `UPS_AI_Behavior_PersonalityComponent`)
|
|
- **UI display**: `"PS AI Behavior"` (categories, DisplayName)
|
|
- **Interface**: `IPS_AI_Behavior_Interface` — implements on host project Pawns
|
|
|
|
## PS_AI_Behavior — Architecture
|
|
|
|
### Core Design
|
|
- **Interface-driven**: `IPS_AI_Behavior_Interface` on Pawns decouples plugin from host project
|
|
- **Personality profiles**: DataAsset with 5 trait axes, thresholds, target priority, speed per state
|
|
- **NPCType enum**: Civilian, Enemy, Protector, Any (unified — no separate SplineCategory)
|
|
- **TeamIds**: Civilian=1, Enemy=2, Protector=3, auto-assigned in OnPossess
|
|
- **Hostile switch**: Enemy with IsBehaviorHostile=false → TeamId=1 (disguised), flips to 2 at runtime
|
|
|
|
### Blackboard
|
|
- Key `BehaviorState` = Enum type, path: `/Script/PS_AI_Behavior.EPS_AI_Behavior_State`
|
|
- Values: Idle(0), Patrol(1), Alerted(2), Combat(3), Fleeing(4), TakingCover(5), Dead(6)
|
|
- BB asset created manually in editor (runtime fallback exists but prefer asset)
|
|
- SetValueAsEnum / GetValueAsEnum (not Int)
|
|
|
|
### BT Pattern
|
|
- Services on Selector: UpdateThreat + EvaluateReaction
|
|
- Decorator Observer Aborts = Both on Combat/Flee branches
|
|
- Spline branch as fallback (lowest priority, no condition decorator)
|
|
- Attack task stays InProgress permanently, Decorator pulls out on state change
|
|
|
|
### Spline System
|
|
- SplinePath actors placed in level, SplineCategory = NPCType
|
|
- SplineNetwork WorldSubsystem auto-detects junctions
|
|
- SplineFollowerComponent on Pawns: uses Pawn's real velocity, debug green sphere
|
|
- Junction switching: 70% probability, direction filter (dot > -0.5)
|
|
|
|
### Perception
|
|
- Senses configured in BeginPlay (NOT constructor — NewObject crashes in CDO)
|
|
- RequestStimuliListenerUpdate() after ConfigureSenses
|
|
- Detect ALL affiliations, filter by Hostile attitude in CalculateThreatLevel
|
|
- Target priority from PersonalityProfile (combat targeting)
|
|
|
|
### Known Gotchas (UE 5.5)
|
|
- BB Enum picker doesn't list plugin enums — use string path
|
|
- NTFS junctions (not symlinks) for UE5 cross-project plugin linking
|
|
- SVN doesn't traverse junctions — robocopy for initial import
|
|
- Live Coding fails on header changes — full rebuild required
|
|
- BlueprintNativeEvent: UHT auto-generates _Implementation defaults, don't duplicate in .cpp
|
|
- FGenericTeamId::NoTeam comparison: always recalculate TeamId (BP CDOs may reset to 0)
|
|
|
|
### Testing Status (2026-03-26)
|
|
- ✅ Patrol, Spline following, Perception, Threat, Flee, Combat delegation, Hostile switch
|
|
- 🔲 Cover Points, EQS, Editor tools (SplineEdMode, CoverPoint placement)
|
|
|
|
## Posture System — Diagonal Tilt Bug (à corriger)
|
|
|
|
### Problème
|
|
Le tilt diagonal (ear-to-shoulder) est PLUS VISIBLE avec la neck bone chain qu'avec le mono-bone.
|
|
|
|
### Piste de fix
|
|
Faire le swing-twist **PER-BONE** : pour chaque bone de la chaîne, composer le FractionalRot avec le bone's own rotation, swing-twist autour du bone's own tilt axis.
|
|
|
|
### Fichiers concernés
|
|
- `AnimNode_PS_AI_ConvAgent_Posture.cpp` — Evaluate_AnyThread, section multi-bone chain
|
|
|
|
## Architecture Posture (ConvAgent)
|
|
- **PS_AI_ConvAgent_PostureComponent** (game thread) : cascade Eyes→Head→Body
|
|
- **AnimNode_PS_AI_ConvAgent_Posture** (anim thread) : applique rotation sur bone(s) + injecte curves
|
|
- Pipeline 100% FQuat, Thread safety via FCriticalSection
|
|
- ARKit eye curves normalisées par range fixe (40°/35°)
|