AI Cockpit Reasoning
Languages: English | Português
English
Turn requirements into code with AI assistance. Use AI Cockpit Reasoning in VS Code or the AI Cockpit CLI in the terminal to explore projects, plan changes and implement features.
Key features
- Project assistance: explore code, ask questions and request changes.
- Planning and implementation: organize tasks and follow their execution.
- Terminal and tools: run actions according to the configured permissions.
- MCP integrations: connect external tools and services.
- Result review: inspect the changes and validate the generated code.
In the VS Code extension, you also get:
- Reasoning Board: select project requirements to start an implementation.
- Agent Manager: organize multiple work sessions.
- Autocomplete and assisted editing: get assistance while you edit code.
- Browser automation: use browsing and testing capabilities when enabled.
Models and usage
The model catalog is loaded for the selected organization. Check the model picker in the app to see the available options.
- Availability: depends on the organization and the service configuration.
- Capabilities: support for images, reasoning and context limits depends on the model.
- Usage: track your budget, amount used and balance in your profile.
- Free usage: depends on your account terms; installing the extension does not guarantee it.
Using the Reasoning Board
- Open the Reasoning Board in VS Code.
- Configure the requirements source, if needed.
- Select the workspace, epic and story.
- Choose whether to work on the story or on its subtasks.
- Review the execution options and start the work.
- Follow the session and review the result.
Review the generated code and run the relevant tests before integrating the changes.
AI Cockpit ecosystem integration
Lens — knowledge bases
Connect your project work to your organization's knowledge bases. The agent can query Lens for information relevant to your request, according to the available bases and your access permissions.
In VS Code:
- Sign in with your AI Cockpit account and select the organization.
- Open the extension settings and find Knowledge Bases under Indexing.
- Refresh the list and enable the bases you want to use.
- In the conversation, ask the agent to query those bases to guide the task.
Agent queries depend on the search tool being available and on the session permissions.
In the CLI:
After signing in, list the available bases:
aic lens list
Enable a base using the ID returned in the list:
aic lens enable <id>
Check the selection or disable a base:
aic lens status
aic lens disable <id>
In the CLI, enabled bases can also provide context to your requests automatically. In VS Code, use the agent query described above.
Smart Engineering — integration via the Modernization MCP
In VS Code and in the CLI, the agent can access the Modernization service through the aic-documentation MCP server, included in the default AI Cockpit configuration.
The connection uses your AI Cockpit account authentication. The available tools are loaded from the MCP server; the operations you can perform depend on the service and on your account permissions.
- Sign in with your AI Cockpit account and select the desired organization.
- Check that the
aic-documentation MCP is connected.
- In the conversation, ask the agent to identify the Modernization tools available for the task.
- Describe the goal and provide the data the operation asks for.
- Follow the tool calls and results in the conversation.
Example request:
Check the tools available in the aic-documentation MCP and explain how I can use them to work with this project's documentation.
To run these operations through the agent, use a model and a gateway that support tool calling. Check the list of actions and their requirements on the active connection, since it is provided by the service.
First access in VS Code
- Open the AI Cockpit Reasoning panel.
- Start the login and complete authentication in the browser.
- Select your organization.
- Choose an available model and send your first request.
Installing the AI Cockpit CLI
Use the AI Cockpit CLI directly in your projects' terminal.
Linux and macOS
curl --proto '=https' --tlsv1.2 -fsSL https://cli.aicockpit.ai/install | bash -
Windows — PowerShell
irm https://cli.aicockpit.ai/install.ps1 | iex
Verify the installation
Open a new terminal and run:
aic --version
Set up and get started
In your project folder, start the CLI:
aic
Complete authentication with your AI Cockpit account and select the organization and model available to you.
To see the commands and options:
aic --help
Versions and updates
VS Code: check the installed version on the extension page and whether you are using a stable or pre-release version.
CLI: check the installed version with:
aic --version
See the release notes for that version to learn about its changes.
Troubleshooting
The aic command is not found
Open a new terminal after installing. If the problem persists, check the installer messages and whether the installation directory was added to your PATH.
I can't sign in or access my organization
Check that authentication was completed in the browser and that your account has access to the organization.
A model does not appear
Check the selected organization. The catalog depends on the options made available to it.
I need to investigate a failure
In VS Code, open View → Output and check the extension logs.
When asking for support, include the client you use (VS Code or CLI), the installed version, your operating system and the steps to reproduce the problem.
Português
Transforme requisitos em código com assistência de IA. Utilize o AI Cockpit Reasoning no VS Code ou a AI Cockpit CLI no terminal para explorar projetos, planejar alterações e implementar funcionalidades.
Principais recursos
- Assistência no projeto: explore código, tire dúvidas e solicite alterações.
- Planejamento e implementação: organize tarefas e acompanhe sua execução.
- Terminal e ferramentas: execute ações conforme as permissões configuradas.
- Integrações MCP: conecte ferramentas e serviços externos.
- Revisão de resultados: examine as alterações e valide o código produzido.
Na extensão para VS Code, você também encontra:
- Reasoning Board: selecione requisitos do projeto para iniciar uma implementação.
- Agent Manager: organize múltiplas sessões de trabalho.
- Autocompletar e edição assistida: receba assistência durante a edição de código.
- Automação de navegador: utilize recursos de navegação e testes quando habilitados.
Modelos e consumo
O catálogo de modelos é carregado para a organização selecionada. Consulte o seletor da aplicação para verificar as opções disponíveis.
- Disponibilidade: varia conforme a organização e a configuração do serviço.
- Recursos: suporte a imagens, raciocínio e limites de contexto depende do modelo.
- Consumo: acompanhe o orçamento, o valor utilizado e o saldo no perfil.
- Gratuidade: depende das condições da sua conta; não é garantida pela instalação.
Usando o Reasoning Board
- Abra o Reasoning Board no VS Code.
- Configure a fonte de requisitos, quando necessário.
- Selecione workspace, épico e história.
- Escolha trabalhar com a história ou com suas subtarefas.
- Confira as opções de execução e inicie o trabalho.
- Acompanhe a sessão e revise o resultado.
Revise o código gerado e execute os testes relevantes antes de integrar as alterações.
Lens — bases de conhecimento
Conecte o trabalho no projeto às bases de conhecimento da sua organização. O agente pode consultar o Lens para buscar informações relevantes à solicitação, conforme as bases disponíveis e as permissões de acesso.
No VS Code:
- Entre com sua conta AI Cockpit e selecione a organização.
- Abra as configurações da extensão e localize Bases de conhecimento, na área de indexação.
- Atualize a lista e habilite as bases que deseja utilizar.
- Na conversa, solicite ao agente que consulte essas bases para orientar a tarefa.
As consultas do agente dependem da disponibilidade da ferramenta de busca e das permissões da sessão.
Na CLI:
Após autenticar-se, consulte as bases disponíveis:
aic lens list
Habilite uma base usando o identificador retornado na lista:
aic lens enable <id>
Confira a seleção ou desabilite uma base:
aic lens status
aic lens disable <id>
Na CLI, as bases habilitadas também podem fornecer contexto automaticamente às solicitações. No VS Code, utilize a consulta pelo agente descrita acima.
Smart Engineering — integração via MCP Modernization
No VS Code e na CLI, o agente pode acessar o serviço Modernization por meio do servidor MCP aic-documentation, incluído na configuração padrão do AI Cockpit.
A conexão utiliza a autenticação da sua conta AI Cockpit. As ferramentas disponíveis são carregadas do servidor MCP; as operações que você pode realizar dependem do serviço e das permissões da sua conta.
- Entre com sua conta AI Cockpit e selecione a organização desejada.
- Confira se o MCP
aic-documentation está conectado.
- Na conversa, solicite ao agente que identifique as ferramentas de Modernization disponíveis para a tarefa.
- Descreva o objetivo e forneça os dados que a operação solicitar.
- Acompanhe as chamadas de ferramentas e os resultados na conversa.
Exemplo de solicitação:
Consulte as ferramentas disponíveis no MCP aic-documentation e explique como posso utilizá-las para trabalhar com a documentação deste projeto.
Para executar essas operações pelo agente, utilize um modelo e um gateway compatíveis com tool calling. A lista de ações e seus requisitos deve ser consultada na conexão ativa, pois é fornecida pelo serviço.
Primeiro acesso no VS Code
- Abra o painel AI Cockpit Reasoning.
- Inicie o login e conclua a autenticação no navegador.
- Selecione sua organização.
- Escolha um modelo disponível e envie sua primeira solicitação.
Instalação da AI Cockpit CLI
Utilize a AI Cockpit CLI diretamente no terminal dos seus projetos.
Linux e macOS
curl --proto '=https' --tlsv1.2 -fsSL https://cli.aicockpit.ai/install | bash -
Windows — PowerShell
irm https://cli.aicockpit.ai/install.ps1 | iex
Verificar a instalação
Abra um novo terminal e execute:
aic --version
Configurar e começar
Na pasta do seu projeto, inicie a CLI:
aic
Conclua a autenticação com sua conta AI Cockpit e selecione a organização e o modelo disponíveis para seu acesso.
Para consultar os comandos e as opções:
aic --help
Versões e atualizações
VS Code: consulte a versão instalada na página da extensão e verifique se está utilizando uma versão estável ou de pré-lançamento.
CLI: consulte a versão instalada com:
aic --version
Consulte as notas da versão correspondente para conhecer suas alterações.
Solução de problemas
O comando aic não foi encontrado
Abra um novo terminal após a instalação. Se o problema persistir, confira as mensagens do instalador e se o diretório de instalação foi incluído no PATH.
Não consigo entrar ou acessar minha organização
Verifique se a autenticação foi concluída no navegador e se sua conta possui acesso à organização.
Um modelo não aparece
Confira a organização selecionada. O catálogo depende das opções disponibilizadas para ela.
Preciso investigar uma falha
No VS Code, abra Exibir → Saída e consulte os registros da extensão.
Ao solicitar suporte, informe o cliente utilizado — VS Code ou CLI —, a versão instalada, o sistema operacional e os passos para reproduzir o problema.
