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á. # OpenSearch Habilidades do agente Atualmente, os desenvolvedores podem passar da ideia ao protótipo funcional em minutos usando agentes IDEs como Kiro, Claude Code e Cursor. Mas se você está experimentando uma nova ideia, criando uma prova de conceito ou executando sistemas de produção, a experiência rapidamente se torna mais complexa. Os resultados da pesquisa não se comportam conforme o esperado, os picos de latência exigem a análise dos registros e a implantação AWS introduz decisões de configuração que exigem profundo conhecimento. Traduzir intenções de alto nível em consultas DSLs, configurações de índice e fluxos de trabalho de várias etapas ainda leva um tempo significativo, mesmo com um agente de IA ao seu lado. [OpenSearch O Agent Skills](https://github.com/opensearch-project/opensearch-agent-skills) aborda isso fornecendo um repositório de habilidades que trazem OpenSearch inteligência diretamente para seu agente. Cada habilidade engloba o conhecimento do domínio, as melhores práticas e a lógica de execução em várias etapas para um fluxo de trabalho específico, para que seu agente não apenas obtenha resultados, mas entenda como eles foram alcançados. As habilidades funcionam com qualquer agente de codificação que suporte o [padrão Agent Skills](https://agentskills.io/specification), incluindo Kiro, Claude Code e Cursor. ## O que você pode fazer com Agent Skills ### Crie um aplicativo de pesquisa local A `opensearch-launchpad` habilidade traz uma experiência orientada pela intenção para criar e iterar aplicativos de pesquisa. Ele traduz requisitos de linguagem natural ou dados de amostra em um OpenSearch índice totalmente configurado — com mapeamentos otimizados, pipelines de ingestão e integrações de modelos de ML para pesquisa por palavra-chave, semântica e híbrida — e produz uma experiência de pesquisa funcional pronta para ser testada e repetida. Exemplo de solicitação: ``` Build a semantic search application for product documentation ``` O agente configura os mapeamentos de índice, configura um modelo de incorporação e um pipeline de ingestão e retorna uma API de pesquisa e uma interface de usuário funcionais, orientando você em cada decisão ao longo do caminho. ### Investigue incidentes com análise de registros A `log-analytics` habilidade traz inteligência agente aos fluxos de trabalho de observabilidade. Em vez de criar consultas manualmente em Piped Processing Language (PPL) ou reunir dados de log em vários serviços, você expressa sua intenção e a habilidade lida com a complexidade — da detecção de padrões de erro à análise de anomalias e à correlação da causa raiz. Exemplo de solicitação: ``` Investigate why my service is returning 500s and correlate with recent traces ``` O agente executa consultas PPL para revelar padrões de erro e registrar anomalias de volume e, em seguida, correlaciona os erros de registro a um rastreamento específico para uma análise mais rápida da causa raiz, sem exigir que você domine a sintaxe do PPL ou navegue manualmente IDs pelos dados de rastreamento. ### Investigue rastreamentos distribuídos A `trace-analytics` habilidade investiga traços distribuídos diretamente em seu interior OpenSearch. Ele identifica períodos lentos, períodos de erros e dependências de serviços, além de correlacionar registros e rastreamentos usando o rastreamento IDs até a superfície das causas básicas em toda a pilha de observabilidade. Exemplo de solicitação: ``` Which service is causing the p99 latency regression in the checkout flow? ``` O agente cria um mapa de serviços, identifica os períodos lentos e identifica o gargalo, sem exigir que você navegue manualmente pelos dados de rastreamento entre os serviços. ### Implemente OpenSearch em AWS A `aws-setup` habilidade orienta seu agente no provisionamento de um domínio de OpenSearch serviço ou coleção OpenSearch sem servidor, na configuração de políticas de acesso e criptografia e na conexão de seu aplicativo — com guias separados para domínios gerenciados e coleções sem servidor. Exemplo de solicitação: ``` Set up an OpenSearch Serverless collection for my search application ``` O agente lida com o provisionamento, a configuração de políticas e a validação, orientando você em cada etapa. ## Habilidades disponíveis As habilidades são organizadas por categoria. Você pode instalar a coleção completa ou habilidades individuais: | Categoria | Habilidade | O que ela faz | | --- | --- | --- | | Pesquisa | opensearch-launchpad | Estrutura um aplicativo de busca do zero. Abrange pesquisa BM25 lexical, pesquisa semântica, pesquisa híbrida e pesquisa agêntica. Inclui guias de seleção de modelos, estratégias de avaliação e dados de amostra. | | Observabilidade | log-analytics | Consulta e analisa registros usando Piped Processing Language (PPL). Ajuda o agente a detectar padrões de erro, anomalias superficiais e correlacionar eventos entre índices. | | Observabilidade | trace-analytics | Investiga traços distribuídos. Identifica períodos lentos, cria mapas de serviço e rastreia invocações de ferramentas de agentes de IA em seu sistema. | | Nuvem | aws-setup | Implanta em OpenSearch . AWS Inclui guias dedicados para domínios do Amazon OpenSearch Service e coleções OpenSearch Serverless, abrangendo provisionamento, políticas de acesso e configuração de rede. | O projeto está em desenvolvimento ativo. Para obter a lista de habilidades e as orientações de contribuição mais recentes, consulte o [opensearch-agent-skills](https://github.com/opensearch-project/opensearch-agent-skills)repositório. ## Pré-requisitos Os pré-requisitos variam de acordo com a habilidade. Para usar a coleção completa, você precisa: + Um agente de codificação que oferece suporte às habilidades do agente (Claude Code, Cursor ou Kiro). + [Node.js](https://nodejs.org/) com `npx` no seu`PATH`, para executar o `skills` instalador. + [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/)e Python 3.11 ou posterior. Habilidades usadas `uv` para executar scripts em ambientes isolados. + [Docker](https://docs.docker.com/get-docker/) instalado e em execução, se você planeja usar habilidades que geram um cluster local (como`opensearch-launchpad`). + AWS credenciais configuradas com as permissões apropriadas se você planeja usar a `aws-setup` habilidade. Para obter orientação sobre as permissões necessárias, consulte[Políticas baseadas em identidade](ac.md#ac-types-identity). ## Instalar e usar habilidades As habilidades são instaladas por meio da [https://agentskills.io](https://agentskills.io)CLI, com a qual você invoca. `npx` O instalador detecta seu agente e coloca os arquivos de habilidades no local correto. Para instalar a coleção inteira: ``` npx skills add opensearch-project/opensearch-agent-skills ``` Para instalar uma única habilidade, use o `@skill-name` sufixo. A `--full-depth` bandeira inclui todo o material de referência que o agente possa precisar para perguntas complementares: ``` npx skills add opensearch-project/opensearch-agent-skills@opensearch-launchpad --full-depth npx skills add opensearch-project/opensearch-agent-skills@log-analytics --full-depth npx skills add opensearch-project/opensearch-agent-skills@trace-analytics --full-depth npx skills add opensearch-project/opensearch-agent-skills@aws-setup --full-depth ``` Opções comuns de instalação: **`-a {{agent-name}}`** Instale em um agente específico, por exemplo`-a claude-code`. **`-g`** Instale globalmente para que a habilidade esteja disponível em todos os projetos em sua máquina. **`--all`** Instale em cada agente que a CLI detecta em sua máquina. Após a instalação, reinicie seu agente para que ele pegue os novos arquivos de habilidades. Em seguida, tente uma mensagem como *“Quero criar um aplicativo de pesquisa híbrido com” OpenSearch.* O agente lê as instruções da habilidade e executa diretamente os scripts necessários. A `aws-setup` habilidade inclui guias dedicados para ambas as famílias OpenSearch de produtos de serviço. Para domínios gerenciados do Amazon OpenSearch Service, a habilidade explica a criação de um domínio, a configuração de políticas de acesso e a conexão do seu aplicativo (consulte[Introduction](what-is.md)). Para OpenSearch Serverless, abrange a criação de uma coleção, a configuração de políticas de acesso e criptografia de dados e a ingestão de dados (consulte). [Amazon sem OpenSearch servidor](serverless.md) Para consultas interativas em um cluster em execução, combine as habilidades com o. [OpenSearch Servidor MCP](opensearch-mcp-server.md) ## Considerações sobre segurança Quando você instala e executa uma habilidade, seu agente executa os scripts e comandos que ela descreve. Trate as habilidades como faria com qualquer ferramenta de desenvolvimento terceirizada: + Revise o `SKILL.md` arquivo da habilidade no [repositório de origem](https://github.com/opensearch-project/opensearch-agent-skills) antes da instalação. + Execute habilidades em um ambiente de desenvolvimento ou sandbox antes de direcioná-las aos recursos de produção. + Use credenciais do IAM com privilégios mínimos ao executar a `aws-setup` habilidade, com escopo definido para Conta da AWS e Região da AWS onde você pretende implantar. + Analise todos AWS os recursos que a habilidade cria antes de se comprometer com uma infraestrutura de longa duração. As habilidades podem provisionar domínios, coleções, funções do IAM e recursos de rede em seu nome. ## Recursos adicionais do + [opensearch-agent-skills](https://github.com/opensearch-project/opensearch-agent-skills)on GitHub — Fonte, problemas e o guia do desenvolvedor para criar novas habilidades. + [Especificação de habilidades do agente](https://agentskills.io/specification) — O padrão aberto que as habilidades implementam. + [OpenSearch Servidor MCP](opensearch-mcp-server.md)— O servidor MCP complementar para consultas interativas em um cluster em execução.