Skip to main content
Você precisa de uma conta ou chave de API para o gateway MKA1 da sua organização. O pacote desktop inclui o ambiente de execução do agente; você não precisa instalar a CLI nem compilar a aplicação a partir do código-fonte. Antes de baixar, confira se sua organização exige uma distribuição própria. Se exigir, use esse pacote; caso contrário, use os downloads públicos abaixo. Você também precisa de acesso de rede ao gateway e de uma conta ou chave de API autorizada. A lista de modelos depende desse acesso. O aplicativo inclui o ambiente de execução do agente, mas não instala as ferramentas do projeto. Um projeto JavaScript, por exemplo, pode precisar de Node.js e dependências para executar testes. Você pode instalar o aplicativo e conectar a conta antes de preparar um projeto.

​
1. Baixe

Baixe o instalador desktop para seu sistema operacional e processador. Estes links correspondem ao MKA1 Code 1.57.4. O manifesto da versão pública lista a versão publicada e as somas de verificação dos pacotes. No macOS, abra Sobre Este Mac para conferir se o computador tem chip Apple ou processador Intel. Os downloads do Windows oferecem suporte a x64. No Linux, escolha ARM64 para processadores ARM ou x64 para x86-64. O pacote precisa corresponder ao computador em que o aplicativo desktop será executado.

​
Distribuições de organizações

Se sua organização fornecer uma distribuição com marca própria ou exigir uma versão específica, use os pacotes dela:
  1. Abra Aplicativos no console MKA1 e faça login. Se sua organização usar outro endereço para o console, abra esse console e selecione Aplicativos no final da barra lateral.
  2. Selecione sua organização. A distribuição pode ter outro nome e logotipo.
  3. No cartão de download da aplicação, use Plataforma para selecionar o sistema operacional e o processador.
  4. Escolha Baixar ao lado de Aplicativo para desktop. Para as outras interfaces, escolha o pacote da extensão do VS Code ou da CLI.
Se a distribuição exigida pela organização não aparecer ou não estiver disponível para sua plataforma, peça ao administrador o instalador e acesso ao gateway.

​
2. Instale

  1. Abra o arquivo .dmg baixado.
  2. Arraste o aplicativo para Aplicativos e espere a cópia terminar.
  3. Ejete a imagem de disco e abra o aplicativo instalado em Aplicativos. Execute a cópia instalada, não a que está dentro da imagem de disco.
  4. Continue em Conecte sua conta abaixo.
Se o sistema operacional bloquear o instalador ou o aplicativo, peça ao administrador o procedimento de instalação da sua organização.

​
3. Conecte sua conta

A autenticação abre no navegador. O código exibido pelo aplicativo identifica a solicitação de autorização que você precisa confirmar:
  1. Inicie o login. O aplicativo exibe um código de autorização e abre o navegador.
  2. No navegador, entre com a conta da sua organização. Confira se o navegador e o aplicativo exibem o mesmo código antes de aprovar o acesso. Enquanto aguarda, você pode copiar o código ou reabrir a página de autorização pelo aplicativo.
  3. Volte ao aplicativo quando a autorização terminar. Consulte o seletor de modelos para ver os modelos disponíveis pelo gateway.
Se sua organização fornecer uma chave de API, abra Ajustes → Acesso, selecione Chave de API, informe a chave e escolha Usar chave de API. O aplicativo valida a chave antes de ativá-la. Os recursos que exigem a identidade da conta, incluindo a memória do projeto, continuam exigindo login com uma conta.

Escolha o login com conta ou uma chave de API em Ajustes → Acesso.

​
Escolha um modelo

Abra o seletor e escolha um modelo disponível pelo gateway. Para uma pergunta de código em texto, comece com um modelo recomendado pela organização para programação. Para anexar capturas de tela, escolha um que aceite imagens. Um seletor vazio indica um problema de conexão ou catálogo a resolver antes da tarefa; não significa que o projeto esteja vazio. Se o login retornar ao aplicativo sem modelos, confira a conexão abaixo. Se a autorização expirou, solicite outro código e repita o login. Consulte Consumo e solução de problemas para as etapas de recuperação.

​
Confira a conexão

Em Ajustes → Conexão, use a URL do gateway fornecida pelo administrador. Com uma credencial ativa, escolha Testar conexão para conferir o acesso e os modelos disponíveis. O teste não salva as alterações; escolha Salvar para aplicá-las. Alterar a origem do servidor remove a credencial ativa, então autentique-se novamente após salvar. Você também pode escolher idioma e tema em Ajustes. Nas sessões locais, o agente e as ferramentas do projeto são executados no seu computador. Nas sessões remotas, são executados no ambiente selecionado. Prompts, conteúdo relevante dos arquivos e resultados das ferramentas são enviados ao gateway MKA1 configurado como contexto para as solicitações ao modelo.

​
Verifique a instalação

Após fazer login, confira se o seletor mostra os modelos do seu gateway. Abra um projeto local em Código e envie uma solicitação cujo resultado você possa conferir, como:
Leia README.md e explique o que este projeto faz. Não altere arquivos.
Se o projeto não tiver README.md, indique outro arquivo de texto que ele contenha. Confira se uma resposta chega e examine o resultado da leitura do arquivo na linha do tempo. Para executar comandos do projeto, instale as dependências habituais e as ferramentas de compilação ou teste. O Git é necessário para usar branches, worktrees e commits. Em sessões remotas, essas ferramentas precisam estar instaladas no ambiente selecionado. Continue com Início rápido.