View a markdown version of this page

Usando um assistente de codificação para agilizar seus fluxos de trabalho de aprendizado de máquina - SageMaker Inteligência Artificial da Amazon

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 de assistente de codificação integrado 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 interativo diretamente em seu ambiente. JupyterLab

Quando você usa assistentes de codificação na Amazon SageMaker AI JupyterLab, o espaço carrega automaticamente as habilidades relevantes de SageMaker IA da Amazon no contexto do seu assistente. Essas habilidades são carregadas do GitHub repositório 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 adequam ao seu fluxo de trabalho. ACP-compatible os assistentes podem se beneficiar da mesma integração do Amazon SageMaker AI Skills quando usados no 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

  1. Navegue até o Amazon SageMaker AI Studio

  2. Vá para Spaces no painel de navegação esquerdo ou clique em “Personalizar com agente” no hub do modelo

  3. 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 exige 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.

  1. Em JupyterLab, abra o painel de bate-papo clicando no ícone de bate-papo na barra lateral direita

  2. Você pode digitar @ para ver seus agentes disponíveis

  3. Selecione @Kiro no menu suspenso do agente

  4. Comece a fazer perguntas ou solicitar assistência com códigos

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:

  1. Em JupyterLab, abra um novo terminal: Arquivo > Novo > Terminal

  2. Execute o seguinte comando

    kiro-cli login --use-device-flow

Selecione uma das 3 opções de login no terminal:

  1. Use gratuitamente com o Builder ID

  2. Use gratuitamente com o Google ou GitHub

  3. 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 as habilidades de SageMaker IA da Amazon em Kiro

As habilidades de SageMaker IA da Amazon estão disponíveis automaticamente quando você usa o Kiro em SageMaker JupyterLab. Essas habilidades são carregadas do GitHub repositório do 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 práticas SageMaker recomendadas e dos padrões de API mais recentes à medida que eles evoluem. Para atualizar suas habilidades, você pode extrair as versões mais recentes do repositório do 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 para obter mais informações. Para visualizar as habilidades disponíveis em seu ambiente, navegue até a .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 apoiam o ACP incluem:

  • Claude (via claude-agent-acp)

  • OpenCode(via Opencode CLI >= 1.0.0)

  • Gêmeos (via Gemini CLI >= 0,34,0)

  • Codex (via codex-acp)

Para usar um assistente de ACP-compatible codificação diferente:

  1. Instale a ferramenta CLI do assistente em seu JupyterLab terminal:

    Para Claude: npm install -g @zed-industries/claude-agent-acp

    Para Gêmeos: npm install -g @google/gemini-cli

    Para OpenCode: npm install -g opencode-ai

  2. Reinicie o espaço executando o comando restart-jupyter-server ou 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 em estado de memória (como kernels ativos).

  3. Autentique-se com o assistente seguindo seu processo de autenticação específico

  4. Selecione o assistente na lista suspensa 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 back-end. Siga os pré-requisitos no guia de código Claude, habilitando especificamente o acesso ao modelo Bedrock e fornecendo à sua função de execução acesso e. 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:

  1. Digite @ para ver seus agentes disponíveis

  2. Selecione seu assistente preferido (por exemplo, @Kiro, @Claude, @Gemini)

  3. 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 adaptados à sua tarefa atual. O Amazon SageMaker AI JupyterLab vem com os seguintes perfis Kiro:

  • sagemaker-ai-default: otimizado para o SageMaker desenvolvimento geral de 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 no 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ão técnica de alto nível para projetos de ML.

Para alternar entre os perfis do Kiro em: JupyterLab

  1. Abra o painel de bate-papo do Kiro em JupyterLab

  2. Digite o seguinte comando:

    @Kiro /agent swap <agent name>

    Por exemplo:

    /agent swap kiro-default
  3. Kiro confirmará a troca de perfil e recarregará com os recursos do novo perfil

Recursos adicionais