# MKA1: Brazilian Portuguese ## Brazilian Portuguese - [Brazilian Portuguese / Referência da API (464 pages)](https://docs.mka1.com/_llms/pt-br/referencia-da-api.txt): Documentation for Brazilian Portuguese / Referência da API. ### Desenvolvedores #### Primeiros passos - [Primeiros passos](https://docs.mka1.com/pt/docs/platform-getting-started.md): Do link de convite do cluster à criação de aplicações com o SDK MKA1. Aceite seu convite, configure sua organização, crie uma chave de API e faça sua primeira solicitação. - [Autenticação](https://docs.mka1.com/pt/docs/authentication.md): Autentique-se na API MKA1 com sua chave de API, decida quando enviar X-On-Behalf-Of e troque uma chave de API por um JWT de curta duração. #### SDKs e CLI ##### CLI - [Visão geral do CLI](https://docs.mka1.com/pt/docs/cli/introduction.md): Instale o CLI mka1, habilite a conclusão automática do shell e execute seu primeiro comando da API MKA1 pelo terminal. - [Autenticar a CLI](https://docs.mka1.com/pt/docs/cli/authentication.md): Configure a CLI mka1 com sua chave de API usando flags, variáveis de ambiente, o chaveiro do SO ou um arquivo de configuração — e anexe X-On-Behalf-Of para integrações com vários usuários. - [Comandos](https://docs.mka1.com/pt/docs/cli/commands.md): Explore a árvore de comandos da CLI mka1 com exemplos práticos para Responses, Conversations, Files, Vector Stores, Extract, Speech, Agents e mais. - [Enviar corpos de requisição](https://docs.mka1.com/pt/docs/cli/request-body.md): Construa requisições CLI do mka1 com flags individuais, o atalho JSON --body, ou redirecionamento via stdin — e entenda como as três entradas se combinam. - [Formatar e filtrar saída](https://docs.mka1.com/pt/docs/cli/output-formats.md): Alterne o mka1 CLI entre saída pretty, JSON, YAML, tabela e TOON. Transforme resultados com jq, faça streaming de eventos SSE e controle as cores. - [Depure e inspecione](https://docs.mka1.com/pt/docs/cli/diagnostics.md): Visualize solicitações do mka1 CLI com --dry-run, rastreie-as ao vivo com --debug, explore a árvore de comandos interativamente e ative o modo agente para ferramentas de codificação com IA. #### Respostas - [Gerar uma resposta](https://docs.mka1.com/pt/docs/generate-a-response.md): Use o recurso Responses da API MKA1 para gerar texto, enviar mensagens estruturadas e continuar trocas de várias interações. - [Gerenciar conversas](https://docs.mka1.com/pt/docs/conversations.md): Armazene o estado da conversa na API MKA1, adicione itens de mensagem e continue um fluxo de resposta sem reenviar o histórico completo. - [Respostas em segundo plano](https://docs.mka1.com/pt/docs/background-responses.md): Execute respostas de longa duração em segundo plano e recupere os resultados por polling ou streaming. - [Memória de longo prazo](https://docs.mka1.com/pt/docs/long-term-memory.md): Use a ferramenta de histórico para fornecer aos modelos memória persistente entre sessões, permitindo a recuperação de conversas anteriores por usuário final. - [Repositório de prompts](https://docs.mka1.com/pt/docs/prompt-repository.md): Gerencie modelos de prompt versionados com histórico de alterações, reversão e renderização de variáveis por meio da API Prompts. ##### Exemplos - [Conversas avançadas com ferramentas](https://docs.mka1.com/pt/docs/advanced-conversations.md): Um diálogo completo de 12 turnos com pesquisa na web, correções, contradições e verificação de coerência — mostrando cada solicitação e resposta completa. ##### Entradas - [Entrada multimodal](https://docs.mka1.com/pt/docs/multimodal-input.md): Envie imagens, áudio, documentos e conteúdo misto para a API MKA1 para visão, transcrição, OCR e raciocínio multimodal. ##### Saídas - [Saída multimodal](https://docs.mka1.com/pt/docs/multimodal-output.md): Gere fala em áudio e imagens a partir da API MKA1 usando o recurso Responses. ##### Recuperação - [Usar arquivos e armazenamentos de vetores](https://docs.mka1.com/pt/docs/files-and-vector-stores.md): Faça upload de arquivos para a API MKA1, indexe-os em um armazenamento de vetores e execute busca semântica nos blocos de documentos resultantes. ##### Ferramentas - [Usar ferramentas MCP](https://docs.mka1.com/pt/docs/mcp-tools.md): Conecte um servidor MCP ao recurso Responses da API MKA1, limite as ferramentas permitidas e, opcionalmente, exija aprovação do usuário final. #### APIs independentes - [Fala](https://docs.mka1.com/pt/docs/speech.md): Transcreva áudio e gere fala com a API MKA1. Use segmentos rotulados por locutor quando precisar separar vários locutores. - [Modo de Voz Avançado](https://docs.mka1.com/pt/docs/advanced-voice-mode.md): Crie sessões de voz em tempo real com a API MKA1 usando LiveKit. Configure opções de LLM, ferramentas, ajustes de STT e continuidade de conversas. - [Extrair dados estruturados](https://docs.mka1.com/pt/docs/extract-structured-data.md): Defina um esquema de extração reutilizável na API MKA1 e extraia campos estruturados de arquivos. #### Agentes - [Gerenciar agentes](https://docs.mka1.com/pt/docs/managing-agents.md): Crie definições de agentes reutilizáveis, execute-as mais tarde e inspecione o histórico persistido de execuções. - [Criar um agente com armazenamentos de memória](https://docs.mka1.com/pt/docs/build-an-agent-with-memory-stores.md): Monte memória durável no ambiente de shell gerenciado de um agente salvo e mantenha-a atualizada entre execuções. - [Gerar subagentes usando a API Responses](https://docs.mka1.com/pt/docs/spawn-subagents-using-the-responses-api.md): Use uma ferramenta de função no recurso Responses da API MKA1 para permitir que uma resposta gere respostas filhas e continue após todas retornarem. ##### Exemplos - [Criar um agente com ferramentas MCP](https://docs.mka1.com/pt/docs/build-an-agent-with-mcp-tools.md): Crie um agente salvo que chama um servidor MCP gerenciado pelo cofre com credenciais criptografadas por usuário final. - [Realizando pesquisa aprofundada com subagentes](https://docs.mka1.com/pt/docs/making-deep-research-with-subagents.md): Crie um fluxo de pesquisa aprofundada na API MKA1 usando uma resposta pai para delegar pesquisa web paralela a respostas filhas e sintetizar memorandos de pesquisa concisos. - [Conversacional multicanal](https://docs.mka1.com/pt/docs/multichannel-conversational.md): Demonstre canais de WhatsApp e web compartilhando uma conversa armazenada da API MKA1 com logs de auditoria JSONL unificados. #### Avaliações - [Executar avaliações](https://docs.mka1.com/pt/docs/evals.md): Crie suítes de avaliação reutilizáveis, execute-as em modelos roteados por MKA1 e inspecione resultados, métricas e artefatos por amostra. - [Projetar suítes de tarefas de avaliação](https://docs.mka1.com/pt/docs/evals-task-suites.md): Defina manifestos de avaliação com arquivos enviados, conjuntos de dados do Hugging Face, modelos de prompt, exemplos few-shot, extração de saída, métricas e parâmetros de geração. - [Escrever avaliadores Python](https://docs.mka1.com/pt/docs/evals-python-graders.md): Use avaliadores Python de amostra, lote e baseados em modelo para pontuar execuções de avaliação do MKA1, incluindo juízes LLM e pontuação baseada em embeddings. #### Computação - [Gerenciar repositórios](https://docs.mka1.com/pt/docs/repositories.md): Crie e gerencie repositórios mka1-repos — repositórios git no escopo da organização para os pesos de modelos e conjuntos de dados dos quais as cargas de trabalho do Compute obtêm e para os quais publicam. - [Executar um trabalho de ajuste fino](https://docs.mka1.com/pt/docs/compute-fine-tune-job.md): Faça o ajuste fino de um modelo em GPUs alugadas com um trabalho Compute, monitore o treinamento por logs e SSH e publique os pesos mesclados em mka1-repos. - [Implantar um servidor de modelo](https://docs.mka1.com/pt/docs/compute-deployment.md): Disponibilize um modelo por trás de um endpoint HTTP autenticado com um serviço Compute, obtenha pesos de mka1-repos e registre o endpoint no gateway de LLM. #### Produção - [Limitação de taxa](https://docs.mka1.com/pt/docs/rate-limiting.md): Limites de taxa por chave com cotas configuráveis por minuto, hora ou dia. Inclui demonstração real de HTTP 429 e padrões de repetição. - [Processamento em lote](https://docs.mka1.com/pt/docs/batch-processing.md): Envie grandes volumes de solicitações de forma assíncrona usando a API de Batch. Processe solicitações de Responses, conclusões de chat, embeddings e gerações de imagem em massa dentro de uma janela de conclusão de 24 horas. ### Aplicações #### MKA1 Code ##### Primeiros passos - [MKA1 Code](https://docs.mka1.com/pt/docs/mka1-code.md): Planeje, desenvolva e revise software com um agente de IA em um ambiente desktop baseado na MKA1 API. - [Instalação](https://docs.mka1.com/pt/docs/mka1-code/install.md): Instale o aplicativo desktop, conecte sua conta e confira o gateway e os modelos disponíveis. - [Modelos e provedores](https://docs.mka1.com/pt/docs/mka1-code/models.md): Escolha um modelo do gateway, configure o padrão e adicione um provedor compatível para Código local. - [Início rápido](https://docs.mka1.com/pt/docs/mka1-code/first-task.md): Leia um projeto, reproduza um erro no checkout, verifique a correção e prepare a revisão. ##### Recursos - [Sessões e contexto do projeto](https://docs.mka1.com/pt/docs/mka1-code/sessions.md): Adicione arquivos, oriente tarefas ativas, encontre trabalhos anteriores e confira o contexto. - [Planejamento e permissões](https://docs.mka1.com/pt/docs/mka1-code/permissions.md): Planeje antes de editar e escolha como o agente solicita aprovação para ferramentas. - [Agentes especializados](https://docs.mka1.com/pt/docs/mka1-code/agents.md): Use agentes para investigação ou revisão e defina papéis reutilizáveis com ferramentas e instruções próprias. - [Automação do navegador](https://docs.mka1.com/pt/docs/mka1-code/previews.md): Teste uma aplicação web, acompanhe o navegador e assuma o controle quando necessário. - [Revisão e commits](https://docs.mka1.com/pt/docs/mka1-code/review-changes.md): Confira diffs e testes, escolha o que incluir no commit e envie ou abra um pull request. - [Trabalho paralelo e worktrees](https://docs.mka1.com/pt/docs/mka1-code/workspaces.md): Separe tarefas simultâneas com branches, worktrees e painéis do desktop. - [Desenvolvimento remoto](https://docs.mka1.com/pt/docs/mka1-code/remote-development.md): Execute sessões em hosts SSH, distribuições WSL ou contêineres Docker. - [Tarefas agendadas](https://docs.mka1.com/pt/docs/mka1-code/schedules.md): Execute verificações recorrentes e retome uma conversa local depois. ##### Ferramentas e personalização - [Memória do projeto](https://docs.mka1.com/pt/docs/mka1-code/memory.md): Salve e aprove preferências do projeto para futuras sessões locais. - [Conectores, skills e plugins](https://docs.mka1.com/pt/docs/mka1-code/extensions.md): Conecte ferramentas externas e gerencie instruções reutilizáveis para programar. - [Documentos e arquivos](https://docs.mka1.com/pt/docs/mka1-code/documents.md): Anexe material de referência e revise PDFs, planilhas, apresentações e documentos em sessões locais. ##### Outras interfaces - [Extensão do VS Code](https://docs.mka1.com/pt/docs/mka1-code/vscode.md): Instale o MKA1 Code no VS Code e trabalhe com o agente ao lado dos arquivos. - [CLI](https://docs.mka1.com/pt/docs/mka1-code/cli.md): Instale a CLI do MKA1 Code, abra sessões interativas e execute tarefas em scripts. ##### Suporte - [Atalhos de teclado](https://docs.mka1.com/pt/docs/mka1-code/keyboard-shortcuts.md): Navegue pelo aplicativo desktop, trabalhe com sessões e painéis e personalize os atalhos de teclado. - [Consumo e solução de problemas](https://docs.mka1.com/pt/docs/mka1-code/troubleshooting.md): Consulte o consumo e resolva problemas de acesso, projetos, conectores, ambientes remotos, tarefas e Git. ### Plataforma #### Visão geral - [Visão geral da arquitetura](https://docs.mka1.com/pt/docs/architecture/overview.md): Explore como as capacidades, os serviços e a infraestrutura de suporte do MKA1 se integram. - [Requisitos mínimos do cluster](https://docs.mka1.com/pt/docs/architecture/requirements.md): Requisitos de nós, computação, armazenamento e plataforma para executar o MKA1 — de uma configuração mínima viável a uma implantação altamente disponível. #### Gestão de modelos - [Roteamento automático](https://docs.mka1.com/pt/docs/validate-auto-routing.md): Entenda e valide como o MKA1 seleciona um modelo quando uma solicitação usa o modelo auto. #### Operações - [Auditoria de uso](https://docs.mka1.com/pt/docs/usage-auditing.md): Acompanhe o uso por usuário, correlacione solicitações na borda da API e estruture eventos de auditoria por unidade para detecção de uso indevido. #### Controle de acesso - [Autorização](https://docs.mka1.com/pt/docs/authorization.md): Controle o acesso aos recursos de LLM com autorização baseada em funções. Atribua funções de proprietário, editor ou leitor aos usuários e verifique permissões antes de cada ação. - [Autenticação e isolamento de tenants](https://docs.mka1.com/pt/docs/authentication-deep-dive.md): Demonstre tenants segregados na API MKA1 com chaves de API separadas, cotas separadas, políticas separadas e acesso a recursos com escopo de tenant. #### Segurança e conformidade - [Criptografia de dados](https://docs.mka1.com/pt/docs/data-encryption.md): Veja quais controles de criptografia estão ativos no ambiente MKA1 implantado, como os validamos e as evidências capturadas da produção. - [Chaves protegidas por HSM e TLS 1.3](https://docs.mka1.com/pt/docs/hsm-tls-validation.md): Como o MKA1 utiliza módulos de segurança de hardware validados pela AWS KMS e aplica TLS 1.3 para gerenciamento criptográfico de chaves em dados em repouso e em trânsito. - [Artefatos assinados e cadeia de suprimentos](https://docs.mka1.com/pt/docs/signed-artifacts.md): Como o MKA1 garante a integridade de imagens de contêiner por meio de marcação imutável de artefatos, pipelines CI/CD controlados e uso obrigatório de registros privados. - [GitOps com rollback atômico](https://docs.mka1.com/pt/docs/gitops-atomic-rollback.md): Como o MKA1 usa o Git como fonte única da verdade e Helm com deploys atômicos para garantir rollback automático em caso de falha. - [Procedimento de Autoria](https://docs.mka1.com/pt/docs/authorship-procedure.md): O procedimento para atualizar a autoria a cada nova versão. #### Benchmarks - [Latência de saída em streaming](https://docs.mka1.com/pt/docs/streaming-output-latency.md): Benchmark observado pelo cliente da latência do primeiro token de texto transmitido para a API de Respostas MKA1. - [Avaliação da qualidade de recuperação](https://docs.mka1.com/pt/docs/evaluating-text-stores.md): Resultados de benchmark para o mecanismo de recuperação MKA1 no conjunto de dados BEIR SciFact: precisão, latência e taxa de indexação. - [Avaliação do GraphRAG](https://docs.mka1.com/pt/docs/graphrag.md): Uma comparação de benchmark entre GraphRAG e RAG tradicional em perguntas de recuperação multi-hop. - [Avaliar localização regional e tratamento de ambiguidades](https://docs.mka1.com/pt/docs/evaluating-local-language-and-ambiguity.md): Execute avaliações neutras que comprovem a localização regional espontânea e o comportamento de esclarecimento com o SDK MKA1. - [Embeddings especializados pt-BR](https://docs.mka1.com/pt/docs/pt-br-embeddings.md): Relatório técnico sobre mk-embeddings-pt — um modelo de embeddings para português brasileiro com resultados de benchmarks MTEB, métricas de qualidade semântica e comparação com modelos multilíngues. ## OpenAPI Specs - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=pt-BR)