Tudo o que o sgcAI faz, mapeado nos 15 componentes da página de paleta SGC AI. Converse com sete provedores de modelos por meio de um único componente, hospede ou consuma um servidor Model Context Protocol, indexe seus próprios dados como vetores e comande tudo isso por voz. Toda licença entrega o código-fonte completo. Clique em um componente para abrir a página dele, com propriedades, eventos e exemplos.
O sgcAI é autossuficiente. Tudo o que está nas tabelas abaixo vem em um único pacote, junto com o runtime sgcWebSockets Core sobre o qual os componentes são construídos.
O sgcAI é um produto Windows. O pacote de IA é compilado somente sob MSWINDOWS, portanto 13 dos 15 componentes da paleta são registrados para Win32 e Win64 e não compilam para macOS, Linux, iOS ou Android.
Os dois componentes do Model Context Protocol, TsgcWSAPIServer_MCP e TsgcWSAPIClient_MCP, são a exceção. Eles não têm nenhuma restrição de plataforma e rodam onde quer que a pilha HTTP da sgc rode. Veja Plataformas e linguagens abaixo.
7 provedores, 4 componentes
Cliente e servidor
RAG sobre seus próprios dados
Sistema, Google, Amazon
MCI e Wave
Windows Win32 e Win64, dupla MCP multiplataforma
Todos eles se registram em uma única página de paleta chamada SGC AI.
| Componente | Classe | Família | Descrição |
|---|---|---|---|
| AI Chat | TsgcAIChat | Chat | Um único cliente de chat para OpenAI, Anthropic, Gemini, DeepSeek, Ollama, Grok e Mistral. |
| OpenAI ChatBot | TsgcAIOpenAIChatBot | Chat | Chatbot por voz: grava, transcreve com o Whisper, responde e fala a resposta. |
| OpenAI Translator | TsgcAIOpenAITranslator | Chat | Tradução para o inglês com fala na entrada e fala na saída. |
| OpenAI Assistant | TsgcAIOpenAIAssistant | Chat | API de Assistants: threads, runs, File Search, Code Interpreter e chamada de funções. |
| MCP Server | TsgcWSAPIServer_MCP | MCP | Publique ferramentas, prompts e recursos por HTTP ou HTTP Streamable. |
| MCP Client | TsgcWSAPIClient_MCP | MCP | Consuma qualquer servidor MCP por HTTP, HTTP Streamable ou stdio. |
| OpenAI Embeddings | TsgcAIOpenAIEmbeddings | Vetores | Gere embeddings a partir de texto ou de um arquivo e consulte a correspondência mais próxima. |
| Vector Database (File) | TsgcAIDatabaseVectorFile | Vetores | Armazenamento vetorial local em arquivo, sem servidor e sem conta. |
| Vector Database (Pinecone) | TsgcAIDatabaseVectorPinecone | Vetores | Índice vetorial gerenciado por meio da API REST do Pinecone. |
| Text to Speech (System) | TsgcTextToSpeechSystem | Fala | Fala pelo mecanismo instalado na máquina, sem exigir chave. |
| Text to Speech (Google) | TsgcTextToSpeechGoogle | Fala | Google Cloud Text-to-Speech com autenticação por conta de serviço. |
| Text to Speech (Amazon) | TsgcTextToSpeechAmazon | Fala | Amazon Polly com requisições AWS assinadas e suporte a SSML. |
| Audio Recorder (MCI) | TsgcAudioRecorderMCI | Áudio | Captura do microfone para um arquivo WAV com detecção de silêncio. |
| Audio Recorder (Wave) | TsgcAudioRecorderWave | Áudio | Captura do microfone em streaming com controle total do formato de amostragem. |
| Audio Player (MCI) | TsgcAudioPlayerMCI | Áudio | Reprodução com notificação real de fim de reprodução. |
Sete provedores acessados por uma única propriedade Provider, mais três componentes OpenAI para cenários de voz e de agentes.
| Recurso | Componente | Observações |
|---|---|---|
| OpenAI | TsgcAIChat | Provider := aicpOpenAI. Modelos GPT pela API de Chat Completions. |
| Anthropic | TsgcAIChat | Provider := aicpAnthropic. Modelos Claude pela API de Messages. |
| Google Gemini | TsgcAIChat | Provider := aicpGemini. |
| DeepSeek | TsgcAIChat | Provider := aicpDeepSeek. deepseek-chat e deepseek-reasoner. |
| Ollama (modelos locais) | TsgcAIChat | Provider := aicpOllama. ChatOptions.BaseUrl aponta para o seu próprio host, nada sai da máquina. |
| xAI Grok | TsgcAIChat | Provider := aicpGrok. |
| Mistral | TsgcAIChat | Provider := aicpMistral. |
| Chamada bloqueante | TsgcAIChat | Chat(aMessage) retorna o texto do assistente. |
| Streaming | TsgcAIChat | ChatStream mais OnChatStream, que traz um sinalizador Cancel para abortar no meio da geração. |
| Assíncrono | TsgcAIChat | ChatAsync retorna um future no Delphi 2010 e posteriores. |
| Prompt de sistema | TsgcAIChat | SystemMessage para cada turno, ou ChatWithSystem para um turno isolado. |
| Histórico limitado | TsgcAIChat | MaxHistoryMessages limita o contexto reenviado. ClearHistory e GetHistory gerenciam a transcrição. |
| Controles de amostragem | TsgcAIChat | MaxTokens, Temperature e TopP. Deixe os dois últimos sem valor e o padrão do provedor é aplicado. |
| Documentos e anexos Novidade em 2026.10 | TsgcAIChat | ChatWithDocument, ChatWithDocumentBase64, ChatWithAttachments e ChatJSONWithAttachments enviam PDFs e imagens junto com a mensagem, um ou vários mantidos em uma lista TsgcAIChatAttachments. |
| Extração de documentos Novidade em 2026.10 | TsgcAIDocumentExtractor | Na entrada, um PDF ou uma imagem mais um schema JSON; na saída, um JSON validado. Predefinições dpInvoice, dpReceipt e dpIDCard, um nível de confiança por campo com OnLowConfidence abaixo de MinConfidence, e uma nova tentativa automática quando a resposta não passa na validação. Conecte o TsgcAIOCRTesseract ou o TsgcAIOCRWindows, o OCR embutido no Windows 10 e versões posteriores, para reconhecer o texto localmente, para que um modelo somente de texto no Ollama também consiga extrair. |
| Agente de voz em tempo real Novidade em 2026.10 | TsgcAIVoiceAgent | Escuta, detecta as falas, responde e chama ferramentas sobre a OpenAI Realtime ou a Gemini Live, por WebSocket ou, com a OpenAI, por WebRTC, no Windows, Android e iOS. VAD de servidor, VAD semântico, VAD de cliente ou falas manuais, barge-in que interrompe o agente e trunca sua resposta, transcrições ao vivo do usuário e do agente em OnTranscript, ferramentas de OnToolCall e de um MCPClient atribuído, e G.711 mu-law ou A-law a 8 kHz para telefonia. |
| Fala para texto | TsgcAIOpenAIChatBot, TsgcAIOpenAITranslator | Transcrição e tradução com o Whisper, com um evento para revisar o texto antes do uso. |
| Respostas com recuperação aumentada | TsgcAIOpenAIChatBot | Ligue um componente Embeddings e o contexto recuperado é acrescentado antes de o modelo ser chamado. |
| Assistants, threads e runs | TsgcAIOpenAIAssistant | CreateAssistant, CreateThread, CreateMessageText, CreateRun, CreateRunAndWait. |
| File Search e Code Interpreter | TsgcAIOpenAIAssistant | AssistantOptions.Tools, com UploadVectorStoreFile para adicionar seus próprios documentos. |
| Chamada de funções | TsgcAIOpenAIAssistant | Tools.Functions mais o evento OnFunctionCall. |
As duas pontas do protocolo que os clientes de IA usam para alcançar ferramentas, prompts e recursos. O MCP 2026-07-28 é compatível, com retrocompatibilidade total para 2025-11-25.
| Recurso | Cliente | Servidor | Observações |
|---|---|---|---|
| Transporte HTTP JSON-RPC | aimcptrHttp | TransportOptions.Http | Uma requisição, uma resposta, a conexão se fecha. |
| Transporte HTTP Streamable | aimcptrHttpStreamable | TransportOptions.HttpStreamable | Keep-alive mais um fluxo SSE, que é o que carrega notificações e requisições iniciadas pelo servidor. |
| Transporte stdio | aimcptrStdio | host stdio separado | O cliente inicia um subprocesso local. O stdio do lado servidor é fornecido por uma classe host dedicada, e não pelo componente de paleta. |
| Handshake | Initialize | OnMCPInitialize | Negociação de recursos e atribuição do id de sessão. |
| Sessões | Session, HeartBeat | OnMCPSessionNew, OnMCPSessionEnd, SessionTimeout | Sessões ociosas expiram no servidor, e o cliente pode manter uma viva com pings periódicos. |
| Ferramentas | ListTools, RequestTool | Tools, OnMCPRequestTool | Listar e chamar. O servidor dispara um evento onde o seu código faz o trabalho. |
| Prompts | ListPrompts, RequestPrompt | Prompts, OnMCPRequestPrompt | Mesmo padrão das ferramentas. |
| Recursos | ListResources, RequestResource, ListResourceTemplates | Resources, ResourceTemplates, OnMCPRequestResource | As listagens aceitam um cursor para paginação. |
| Assinaturas de recursos | SubscribeResource, UnsubscribeResource | SendNotificationResourcesUpdated | Acompanhe um recurso e seja avisado quando ele mudar. |
| Notificações de lista alterada | recebidas | SendNotificationToolsListChanged e os equivalentes de prompt e recurso | Exige o transporte streamable. |
| Roots | OnMCPListRoots | RequestRootsList | O servidor pergunta ao cliente quais raízes do sistema de arquivos ele pode usar. |
| Sampling | OnMCPSamplingCreateMessage | RequestSamplingCreateMessage | O servidor pede uma resposta ao modelo do cliente. |
| Elicitation | OnMCPElicitationCreate | RequestElicitationCreate | O servidor pede uma entrada ao usuário por meio do cliente. |
| Completion | Complete | tratado | Autocompletar de valores de argumento para ferramentas e prompts. |
| Log | SetLoggingLevel | SendLogMessage | Mensagens de log estruturadas em um nível controlado pelo cliente. |
| Autenticação | chave de API, cabeçalho personalizado, OAuth 2.0 | chave de API, cabeçalho personalizado, OAuth 2.0 | MCPOptions.AuthenticationOptions nos dois lados. |
| Servidor de autorização integrado | — | ✓ | Registro dinâmico de clientes, página de consentimento, PKCE e refresh tokens, seguindo a RFC 8414 e a RFC 9728. |
| Validação de Origin | — | HttpStreamable.ValidateOrigin | Fixa a sessão ao cabeçalho Origin com que ela foi criada. |
| MCP 2026-07-28 (sem estado) | MCPOptions.ProtocolEra, Discover | era detectada por requisição | Cabeçalhos _meta por requisição, server/discover, Mcp-Method, Mcp-Name e Mcp-Param validados. O cliente recorre automaticamente ao 2025-11-25. |
| Sugestões de cache | recebidas | MCPOptions.Cache | ttlMs e cacheScope nos resultados de 2026-07-28. |
| subscriptions/listen | SubscriptionsListen, SubscriptionsCancel | MCPOptions.Subscriptions | Um único fluxo para mudanças de listas e atualizações de recursos. |
| Multi Round-Trip Requests | OnMCPInputRequired | aResponse.InputRequired, MCPOptions.MRTR | Elicitation (formulário e URL), sampling e roots com requestState assinado por HMAC. |
| Extensão Tasks | MCPOptions.Tasks.Enabled, TasksGet | CreateTask, MCPOptions.Tasks | io.modelcontextprotocol/tasks para chamadas de ferramentas demoradas; o cliente consulta automaticamente com AutoPoll. |
| Autorização do cliente | MCPOptions.Authorization | — | Descoberta de metadados de recurso protegido, Client ID Metadata Documents, fallback de registro dinâmico, PKCE, indicadores de recurso, validação de iss conforme RFC 9207, credenciais por emissor. |
Transforme seus próprios documentos em vetores, guarde-os localmente ou em um índice gerenciado e recupere contexto para cada pergunta.
| Recurso | Armazenamento em arquivo | Pinecone | Observações |
|---|---|---|---|
| Gerar embeddings | ✓ | ✓ | TsgcAIOpenAIEmbeddings.CreateEmbeddings e CreateEmbeddingsFromFile. |
| Divisão em blocos | ✓ | ✓ | EmbeddingsOptions.ChunkSize, padrão de 4096 caracteres. |
| Modelo de embedding | ✓ | ✓ | EmbeddingsOptions.Model, padrão text-embedding-3-small. |
| Upsert em lote | grava ao fechar | um único upsert REST | BeginAddData, AddData, EndAddData nos dois armazenamentos. |
| Consulta ao vizinho mais próximo | QueryData | QueryData | Retorna o texto de origem armazenado por trás do vetor mais próximo. |
| Recuperar contexto para um prompt | ✓ | ✓ | GetEmbedding(aInput, aParams) gera o embedding da consulta e retorna a melhor correspondência. |
| Progresso e cancelamento | ✓ | ✓ | OnCreateEmbeddingsStart, OnCreateEmbeddingsProgress com um sinalizador de continuação, OnCreateEmbeddingsStop. |
| Ganchos por bloco | ✓ | ✓ | OnBeforeCreateEmbedding pode vetar uma requisição, OnAfterCreateEmbedding informa requisição e resposta. |
| Funciona offline | ✓ | — | O armazenamento em arquivo não precisa de rede na consulta. Gerar embeddings ainda chama o provedor. |
| Compartilhado entre máquinas | — | ✓ | Um índice Pinecone pode ser escrito por um aplicativo e lido por outro. |
| Configuração | VectorFileOptions.InputFilename, VectorFilename | PineconeOptions, PineconeIndexOptions | Dois arquivos, ou uma chave de API mais o índice e o id do projeto. |
| Controle de id | OnBeginAddData | OnBeginAddData | Defina o primeiro id e o rótulo do id para que várias ingestões compartilhem o mesmo armazenamento. |
As três compartilham a mesma interface, então o chatbot, o tradutor e o assistente aceitam qualquer uma delas.
| Recurso | Sistema | Amazon | |
|---|---|---|---|
| Falar uma string | TextToSpeech | TextToSpeech | TextToSpeech |
| Precisa de credenciais | não | JSON de conta de serviço | chave de acesso e segredo da AWS |
| Precisa de rede | não | sim | sim |
| Custo por caractere | nenhum | preço do provedor | preço do provedor |
| Seleção de voz | configurações de fala da máquina | Language, VoiceId, Gender | Engine, VoiceId |
| Formato de saída | reprodução direta | AudioEncoding, FileName | OutputFormat, FileName |
| SSML | — | — | TextType |
| Exige reprodutor de áudio | não | sim, AudioPlayer | sim, AudioPlayer |
| Tratamento da autenticação | — | JWT assinado com token de acesso em cache | AWS Signature Version 4 |
| Eventos de início e parada | ✓ | ✓ | ✓ |
Dois gravadores com compromissos diferentes, e o reprodutor que fecha o ciclo de voz.
| Recurso | Gravador (MCI) | Gravador (Wave) | Reprodutor (MCI) |
|---|---|---|---|
| API do Windows usada | MCI | waveIn | MCI |
| Saída | arquivo WAV | fluxo ao vivo | reproduz um arquivo |
| Controle do formato de amostragem | fixo, 16 bits mono 22050 Hz | SampleRate, Channels, BitsPerSample | — |
| Detecção de silêncio | MCIOptions.LevelMin, StopAfter | WaveOptions.LevelMin, StopAfter, WaitForAudio | — |
| Manual ou automático | RecorderOptions.Mode: camoManual ou camoAuto | Start e Stop | Play |
| Instâncias simultâneas | ✓, alias MCI exclusivo por componente | ✓ | ✓ |
| Notificação de fim de reprodução | — | — | ✓, notificação real do MCI, não um timer |
| Usado pelos componentes de voz | gravador padrão | cenários de streaming | saída dos componentes de fala na nuvem |
O que é compatível, dito com precisão.
| Área | Detalhe |
|---|---|
| Sistema operacional | Somente Windows. SGC_AI é definido apenas sob MSWINDOWS, e é ele que controla todo o registro da paleta SGC AI. Não existe build dos componentes de IA para macOS, Linux, iOS ou Android, com a única exceção da dupla MCP abaixo. |
| Delphi | Delphi 7 até o RAD Studio 13 Florence, VCL e FireMonkey, com destino Win32 e Win64. |
| C++ Builder | C++ Builder 10.1 Berlin até o C++ Builder 13, pelos cabeçalhos gerados, com destino Win32 e Win64. |
| Componentes da paleta de IA | 13 dos 15 componentes são declarados como [ComponentPlatforms(pidWin32 or pidWin64)]. Os componentes de chat, agente, embeddings, vetores, fala e áudio são somente Win32 e Win64. |
| Componentes MCP | A exceção. TsgcWSAPIServer_MCP e TsgcWSAPIClient_MCP são declarados como [ComponentPlatforms(0)], portanto não têm nenhuma restrição de plataforma e rodam onde quer que a pilha HTTP da sgc rode, incluindo Windows, macOS, Linux, iOS e Android. |
| Runtime incluído | O runtime sgcWebSockets Core está incluído, então a pilha do cliente HTTP, a camada JSON e o servidor HTTP por trás da API do servidor MCP não precisam de licença separada. |
| TLS | OpenSSL ou SChannel em cada chamada ao provedor, seguindo a configuração do sgcWebSockets. |
| Código-fonte | Código Object Pascal completo em todos os níveis pagos. |
| Redistribuição | Os binários que você gera são livres de royalties, sem taxa de runtime por assento ou por servidor. |