nexus-totvs-platform

Transform TOTVS sales transcripts into structured intelligence via a five-tool Pydantic AI workflow with SSE streaming to PostgreSQL and Redis caching.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Maykesantos98/Fiap-Totvs --skill nexus-totvs-platform
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nexus-totvs-platform
Source: https://github.com/Maykesantos98/Fiap-Totvs/tree/main/.claude/skills/nexus-totvs-platform
Command: npx skills add https://github.com/Maykesantos98/Fiap-Totvs --skill nexus-totvs-platform

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It converts raw TOTVS sales transcripts into structured, audit-friendly outputs and team-ready action plans, so churn risks and product gaps do not get lost.

Core Features & Use Cases

  • End-to-end agent pipeline with Pydantic AI: runs a fixed 5-tool sequence to analyze transcripts, check the product catalog, create development plans, notify the right teams, and update opportunities.
  • Multi-provider model reliability (FallbackModel): supports provider shorthand and failover to reduce single-model downtime.
  • SSE streaming across services: streams tool calls, results, usage, and completion events from the Python agent service through the Node Fastify proxy to the frontend.
  • Dataset-safe security for TOTVS inputs: applies PII redaction with pre-flight detection for already-anonymized TOTVS tokens and blocks prompt injection attempts via a prompt guard.
  • Database-integrated audit trail: persists analysis results, gaps, development plans, and team notifications into PostgreSQL using the project’s canonical schema.

Quick Start

Tell the assistant: "Analyze this TOTVS meeting transcript using the NEXUS pipeline and stream the tool calls live."

Frequently Asked Questions about nexus-totvs-platform

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze TOTVS sales transcripts to identify churn risks and product gaps?

You can turn TOTVS sales transcripts into action plans by running a fixed five-tool Pydantic AI agent workflow. This pipeline structures raw meeting data into audit-friendly outputs, checking the product catalog and creating development plans to prevent churn risks from getting lost.

How does SSE streaming work with Pydantic AI agent workflows?

SSE streaming works with Pydantic AI by streaming tool calls, results, usage, and completion events from the Python agent service through a Node Fastify proxy to the frontend. This end-to-end streaming provides live visibility into the agent pipeline execution.

Can I use multi-provider model fallbacks for TOTVS transcript processing?

Yes, you can use multi-provider model fallbacks for TOTVS transcript processing through FallbackModel support. This accepts provider shorthand and implements failover to reduce single-model downtime during the agent workflow execution.

Does this pipeline support PII redaction for TOTVS inputs before processing?

Yes, the pipeline applies PII redaction for TOTVS inputs using pre-flight detection for already-anonymized tokens. It also blocks prompt injection attempts via a prompt guard to ensure dataset-safe security before analysis.

Do I need canonical NEXUS identifiers to process TOTVS transcripts?

Yes, you need canonical NEXUS identifiers to process TOTVS transcripts through the agent workflow. The pipeline requires these identifiers to properly execute opportunity updates and route development plans within the NEXUS dataset.

What is the best way to persist TOTVS sales transcript analysis results into PostgreSQL?

The best way to persist TOTVS sales transcript analysis results into PostgreSQL is through the pipeline's database-integrated audit trail. It automatically saves analysis results, identified gaps, development plans, and team notifications using the project's canonical schema.