Como criar prompts eficazes para perguntar ao Amazon Q sobre sua frota - AWS Systems Manager

Como criar prompts eficazes para perguntar ao Amazon Q sobre sua frota

Quanto melhor a qualidade da pergunta, ou prompt, que você fornecer ao Amazon Q, melhor será o resultado que ela fornecerá.

Dicas para solicitações de consulta

Lembre-se das dicas a seguir ao consultar o Amazon Q sobre sua frota:

  1. Para ajudar a melhorar a precisão dos resultados, use os termos "nós gerenciados" e "instâncias gerenciadas" em seus prompts, em vez de apenas "nós" e "instâncias".

  2. Para consultar resultados em várias contas que fazem parte de uma organização, conforme configurado em AWS Organizations, você deverá estar conectado à conta de administrador delegado na região de origem designada.

  3. Na conta de administrador delegado, use termos para ajudar a Amazon Q a entender que você está perguntando sobre nós e instâncias em toda a organização usando especificamente termos como "na minha organização" ou "na minha conta 123456789012".

Exemplos de perguntas para o Amazon Q

Na tabela a seguir, fornecemos exemplos de perguntas que demonstram algumas maneiras pelas quais você pode criar consultas do Amazon Q que levam a melhores resultados.

Também fornecemos exemplos dos filtros que o Amazon Q aplicará ao executar o comando ListNodes, os quais são gerados a partir do conteúdo do seu prompt.

Exemplo de pergunta em linguagem natural Filtros aplicados do Amazon Q
Show me my Windows managed nodes.
PlatformType = Windows
List my managed instances in account 123456789012.
AccountId = 123456789012
Show me all managed nodes running Amazon Linux 1 across my organization.
PlatformName = Amazon Linux PlatformVersion = 1
Show me all managed instances running Microsoft Windows Server 2019 Datacenter in my organization.
PlatformName = Microsoft Windows Server 2019 Datacenter
Can you show me all managed nodes with SSM Agent version 3.3.1142.0?
AgentType = amazon-ssm-agent AgentVersion = 3.3.1142.0
List all Amazon Linux 2 managed instances in account 123456789012 that have SSM Agent version 3.3.1230.0.
PlatformName = Amazon Linux PlatformVersion = 2 AccountId = 123456789012 AgentType = amazon-ssm-agent AgentVersion = 3.3.1230.0
What Microsoft Windows Server 2008 R2 Enterprise managed nodes are running in the eu-central-1 region across my entire organization?
PlatformName = Microsoft Windows Server 2008 R2 Enterprise Region = eu-central-1
Show me all managed instances running CentOS Linux 7 in ou-d6ty-gxdma6vm.
PlatformName = CentOS Linux PlatformVersion = 7 OrganizationalUnitId = ou-d6ty-gxdma6vm
What Ubuntu managed instances are in account 123456789012?
PlatformName = Ubuntu AccountId = 123456789012
List my Linux managed instances.
PlatformType = Linux
Find my macOS managed nodes.
PlatformType = macOS
Show me all Amazon Linux managed nodes in my org.
PlatformName = Amazon Linux
List managed nodes running Amazon Linux 2 .
PlatformName = Amazon Linux PlatformVersion = 2
List the managed nodes with Ubuntu 16.04 in account 123456789012.
PlatformName = Ubuntu PlatformVersion = 16.04 AccountId = 123456789012
Find all managed nodes that have an SSM Agent version that is not 3.3.987.0.
AgentType = amazon-ssm-agent AgentVersion != 3.3.987.0
List all managed instances that are not running a Linux operating system.
PlatformType != Linux

Nomes e versões de sistemas operacionais compatíveis para prompts

Quando você pergunta ao Amazon Q sobre os nós gerenciados em sua conta, é útil fornecer o nome de um sistema operacional conforme rotulado no Systems Manager. Você também pode fornecer números de versão para restringir ainda mais os resultados. Por exemplo, conforme representado nas tabelas a seguir, você pode solicitar resultados específicos sobre macOS 14.5, Microsoft Windows Server 2019 Datacenter e AlmaLinux 9.2 through 9.4, apenas para citar alguns exemplos.

Essas listas podem não ser completas e são oferecidas apenas como exemplos.

macOS
nome-da-plataforma Números de versão
macOS 11.6.7, 11.7.10, 12.6.6, 12.7.6, 13.2, 13.4, 13.7, 14.1, 14.5, 14.6.1, 15.0
Windows
Versões Números de versão
Microsoft Windows Server 2008 Enterprise 6.0.6003
Microsoft Windows Server 2008 R2 Datacenter 6.1.7601
Microsoft Windows Server 2008 R2 Enterprise 6.1.7601
Microsoft Windows Server 2008 R2 Standard 6.1.7601
Microsoft Windows Server 2012 R2 Datacenter 6.3.9600
Microsoft Windows Server 2012 R2 Standard 6.3.9600
Microsoft Windows Server 2012 Standard 6.2.9200
Microsoft Windows Server 2016 Datacenter N/D
Microsoft Windows Server 2016 Standard 10.0.14393
Microsoft Windows Server 2019 Datacenter N/D
Microsoft Windows Server 2019 Standard N/D
Microsoft Windows Server 2022 Datacenter N/D
Microsoft Windows Server 2022 Standard 10.0.20348
Linux
Nomes de plataformas Números de versão
AlmaLinux 8.10, 9.2, 9.3, 9.4
Amazon Linux 2 2.0 e posteriores
Amazon Linux 2023 2023.0.20230315.0 e posteriores
Amazon Linux 2015.03, 2015.09, 2016.03, 2016.09, 2017.03, 2017.09, 2018.03
BottleRocket 1.14.3, 1.16.1, 1.18.0, 1.19.1, 1.19.2, 1.19.5, 1.20.0, 1.20.1, 1.20.2, 1.20.3, 1.20.5, 1.21.1, 1.23.0, 1.24.0, 1.24.1, 1.25.0, 1.26.1,
CentOS 6.7, 6.8, 6.9 (Final), 6.10, 6.10 (Final)
CentOS Linux 7, 7.2.1511, 7.2.1511 (Básico), 7.3.1611, 7.3.1611 (Básico), 7.4.1708, 7.5.1804, 7.5.1804 (Básico), 7.6.1810, 7.7.1908, 7.8.2003, 7.9.2009, 7.9.2009 (Básico), 8.2.2004, 8.5.2111
CentOS Stream 8, 9
Debian GNU/Linux 8 – 12
Oracle Linux Server 7.8, 8.2, 8.3, 8.8, 8.9, 8.10, 9.4
Red Hat Enterprise Linux 8.2, 8.3, 8.4, 8.5, 8.6, 8.7, 8.8, 8.9, 8.10, 9.2, 9.3, 9.4
Servidor do Red Hat Enterprise Linux 6.9 (Santiago), 6.10 (Santiago), 7.3, 7.6, 7.7, 7.8,7.9
Rocky Linux 8.6, 8.7, 8.8, 8.9, 8.10, 9.1, 9.2, 9.3, 9.4
SLES 12.4, 15, 15.1, 15.2, 15.3, 15.4, 15.5
Ubuntu 14.04, 16.04, 18.04, 20.04, 22.04, 24.04