Skip to main content

Início rápido para automatizar com CLI do GitHub Copilot

Crie uma automação com CLI do Copilot em minutos.

Visão geral

Você pode usar CLI do GitHub Copilot para executar prompts do Copilot programaticamente. Há duas maneiras principais de fazer isso:

  • Execute um prompt do CLI do Copilot diretamente do seu terminal.
  • Escreva um script ou automação que utilize CLI do Copilot.

Este guia orientará você por um caso de uso simples para cada opção.

Executar um prompt na linha de comando

Quando quiser passar um prompt para o CLI do Copilot sem iniciar uma sessão interativa, use a flag -p.

Shell
copilot -p "Summarize what this file does: ./README.md"

Qualquer prompt que você digitaria em uma sessão interativa é compatível com -p.

Use CLI do Copilot em um script

O poder real do modo programático vem da gravação de scripts para automatizar tarefas alimentadas por IA. Em um script, você pode gerar o prompt ou substituir partes de um prompt por conteúdo dinâmico e, em seguida, capturar a saída ou passá-la para outra parte do script.

Vamos criar um script que encontre todos os arquivos com mais de 10 MB no diretório atual, use CLI do Copilot para gerar uma breve descrição de cada arquivo e, em seguida, enviar um relatório de resumo por email.

  1. No repositório, crie um novo arquivo chamado find_large_files.sh e adicione o conteúdo a seguir.

    Bash
    #!/bin/bash
    # Find files over 10 MB, use Copilot CLI to describe them, and email a summary
    
    EMAIL_TO="user@example.com"
    SUBJECT="Large file found"
    BODY=""
    
    while IFS= read -r -d '' file; do
        size=$(du -h "$file" | cut -f1)
        description=$(copilot -p "Describe this file briefly: $file" -s 2>/dev/null)
        BODY+="File: $file"$'\n'"Size: $size"$'\n'"Description:     $description"$'\n\n'
    done < <(find . -type f -size +10M -print0)
    
    if [ -z "$BODY" ]; then
        echo "No files over 10MB found."
        exit 0
    fi
    
    echo -e "To: $EMAIL_TO\nSubject: $SUBJECT\n\n$BODY" | sendmail "$EMAIL_TO"
    echo "Email sent to $EMAIL_TO with large file details."
    
  2. Torne o script executável.

    Shell
    chmod +x find_large_files.sh
    
  3. Executar o script.

    Shell
    ./find_large_files.sh
    

Este script utiliza CLI do Copilot para gerar descrições dos arquivos que você está procurando, para que você possa entender rapidamente o conteúdo de arquivos grandes sem precisar abri-los.

Você também pode disparar automaticamente esses scripts em resposta a eventos, como um novo arquivo sendo adicionado a um diretório ou em um agendamento usando trabalhos cron ou pipelines de CI/CD.

Leitura adicional

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically)
    
  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/automate-copilot-cli/automate-with-actions)
    
  •         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-programmatic-reference)