As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usando um assistente de codificação para agilizar seus fluxos de trabalho de aprendizado de máquina
Visão geral do
JupyterLab na Amazon, a SageMaker IA inclui suporte integrado ao assistente de codificação por meio do Agent Context Protocol (ACP). Por padrão, o assistente de codificação Kiro é pré-configurado no painel de bate-papo, fornecendo preenchimento de AI-powered código, assistência de depuração e suporte de codificação interativa diretamente em seu ambiente. JupyterLab
Quando você usa assistentes de codificação no Amazon SageMaker AI JupyterLab, o espaço carrega automaticamente as habilidades relevantes do Amazon SageMaker AI no contexto do seu assistente. Essas habilidades são carregadas do GitHub repositório do AWSLabs e fornecem conhecimento especializado sobre SageMaker APIs, fluxos de trabalho de ML, melhores práticas e padrões comuns, permitindo que seu assistente de codificação forneça orientações mais precisas. SageMaker-specific
Além disso, você pode configurar outros assistentes de ACP-compatible codificação de sua escolha, oferecendo flexibilidade para trabalhar com as ferramentas que melhor se adaptam ao seu fluxo de trabalho. ACP-compatible os assistentes podem se beneficiar da mesma integração do Amazon SageMaker AI Skills quando usados na Amazon SageMaker AI JupyterLab.
O que é o Agent Context Protocol (ACP)?
O Agent Context Protocol (ACP) é um protocolo aberto que padroniza a comunicação entre editores de código e agentes de codificação de IA. Isso significa que você pode alternar entre diferentes assistentes de codificação sem aprender novas interfaces ou fluxos de trabalho.
Requisitos mínimos
-
Conta ativa da Amazon SageMaker AI com JupyterLab acesso
-
SageMaker Distribuição (SMD) versão 4.1
-
Para Kiro: credenciais válidas da conta Kiro
Conceitos básicos
Etapa 1: abrir ou criar um SageMaker espaço com JupyterLab
-
Navegue até o Amazon SageMaker AI Studio
-
Vá para Spaces no painel de navegação esquerdo ou clique em “Personalizar com agente” no hub do modelo
-
Há duas opções:
-
Clique em Criar espaço e selecione JupyterLab como seu aplicativo
-
Abra um espaço existente que inclua JupyterLab
-
Etapa 2: Comece a usar o Kiro no painel de bate-papo:
O Kiro requer autenticação antes que você possa usá-lo como seu assistente de codificação. O painel de bate-papo guiará você pelo processo de autenticação.
-
Em JupyterLab, abra o painel de bate-papo clicando no ícone de bate-papo na barra lateral direita
-
Você pode digitar @ para ver seus agentes disponíveis
-
Selecione @Kiro no menu suspenso do agente
-
Comece a fazer perguntas ou solicitar assistência de código
Observe que na primeira vez que você usar o Kiro em um espaço, ele solicitará que você faça login. Para fazer login, siga as instruções fornecidas pelo chat ou siga aqui:
-
Em JupyterLab, abra um novo terminal: Arquivo > Novo > Terminal
-
Execute o seguinte comando
kiro-cli login --use-device-flow
Selecione uma das 3 opções de login no terminal:
-
Use gratuitamente com o Builder ID
-
Use gratuitamente com o Google ou GitHub
-
Use com a licença Pro
Siga as instruções e as telas da opção selecionada.
Exemplos de solicitações:
-
“Quero personalizar um modelo”
Acessando habilidades de SageMaker IA da Amazon no Kiro
As habilidades de SageMaker IA da Amazon estão disponíveis automaticamente quando você usa o Kiro in SageMaker JupyterLab. Essas habilidades são carregadas do GitHub repositório AWSLabs e armazenadas nas .agent/skills pastas .kiro/skills e em seu JupyterLab ambiente, tornando-as compatíveis com qualquer agente carregado desses diretórios.
As habilidades podem ser atualizadas, permitindo que você se beneficie das SageMaker melhores práticas e padrões de API mais recentes à medida que evoluem. Para atualizar suas habilidades, você pode obter as versões mais recentes do repositório AWSLabs. Você pode executar o seguinte comando para atualizar suas habilidades para uso com o Kiro:
npx skills add https://github.com/awslabs/agent-plugins/tree/main/plugins/sagemaker-ai/skills --all --agent kiro-cli --copy
Para outros agentes, consulte o SageMaker AI Skills README .kiro/skills pasta no navegador de JupyterLab arquivos.
Como parte dos novos lançamentos de SageMaker distribuição (SMD), fornecemos versões atualizadas das habilidades. Atualizaremos as habilidades automaticamente, desde que elas não tenham sido modificadas ou excluídas pelo usuário em um espaço. Se você atualizar ou modificar manualmente suas habilidades, use os npx comandos acima para atualizar ou redefinir suas habilidades.
Configurando outros assistentes de codificação com IA JupyterLab
O Amazon SageMaker AI JupyterLab oferece suporte a qualquer assistente de codificação que implemente o Agent Context Protocol (ACP). Exemplos de assistentes que oferecem suporte ao ACP incluem:
-
Claude (via claude-agent-acp)
-
OpenCode(via CLI de código aberto >= 1.0.0)
-
Gêmeos (via CLI de gêmeos >= 0.34.0)
-
Codex (via codex-acp)
Para usar um assistente de ACP-compatible codificação diferente:
-
Instale a ferramenta CLI do assistente em seu JupyterLab terminal:
Para Claude:
npm install -g @anthropic-ai/claude-code @agentclientprotocol/claude-agent-acpPara Gêmeos:
npm install -g @google/gemini-cliPara OpenCode:
npm install -g opencode-ainota
Os pacotes globais do npm são instalados fora do diretório inicial (
/home/sagemaker-user) e não persistem quando o espaço é reiniciado. Para manter a instalação, use uma configuração de ciclo de vida (LCC) ou uma imagem personalizada. https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-byoi-how-to.html -
Reinicie o espaço executando o comando
restart-jupyter-serverou reiniciando o espaço por meio da interface do usuário do Studio. Observe que isso resultará na perda de qualquer trabalho não salvo ou no estado da memória (como kernels ativos). -
Autentique-se com o assistente seguindo seu processo de autenticação específico
-
Selecione o assistente no menu suspenso de persona no painel de JupyterLab bate-papo (por exemplo, @Claude, @Gemini, @) OpenCode
Observe que, especificamente para o Claude Code, você pode configurá-lo para usar o AWS
Bedrock como backend. Siga os pré-requisitos bedrock:InvokeModel bedrock:InvokeModelWithResponseStream Em seguida, crie o arquivo a seguir para configurar o Claude Code para usar o Bedrock.
~/.claude/settings.json:
{ "env": { "CLAUDE_CODE_USE_BEDROCK": "1" } }
Alternando entre assistentes
Você pode alternar entre diferentes assistentes de codificação a qualquer momento:
-
Digite @ para ver seus agentes disponíveis
-
Selecione seu assistente preferido (por exemplo, @Kiro, @Claude, @Gemini)
-
Continue sua conversa com o novo assistente
Cada assistente mantém seu próprio contexto de conversação, para que você possa alternar conforme necessário para diferentes tarefas.
Alternando entre perfis Kiro
O Kiro na Amazon SageMaker AI JupyterLab oferece suporte a vários perfis que são otimizados para diferentes fluxos de trabalho e casos de uso. Você pode alternar entre perfis para acessar diferentes conjuntos de recursos e comportamentos personalizados para sua tarefa atual. A SageMaker IA da Amazon JupyterLab vem com os seguintes perfis do Kiro:
-
sagemaker-ai-default: otimizado para o desenvolvimento geral de SageMaker IA da Amazon com acesso às habilidades de IA da Amazon. SageMaker Esse é o perfil padrão quando você começa a usar o Kiro em SageMaker JupyterLab.
-
kiro-default: perfil padrão do Kiro sem SageMaker-specific personalizações, fornecendo assistência geral de codificação em várias linguagens e estruturas.
-
kiro-planner: focado no planejamento de projetos, design de arquitetura e tomada de decisões técnicas de alto nível para projetos de ML.
Para alternar entre os perfis do Kiro em: JupyterLab
-
Abra o painel de bate-papo do Kiro em JupyterLab
-
Digite o seguinte comando:
@Kiro /agent swap <agent name>Por exemplo:
/agent swap kiro-default -
Kiro confirmará a troca de perfil e recarregará com os recursos do novo perfil