omero-integration

Visão geral da skill omero-integration

Para que serve o omero-integration

A skill omero-integration ajuda você a trabalhar com OMERO em Python quando a tarefa não é “escrever um prompt rápido”, mas sim conectar de forma confiável, buscar objetos de microscopia e manipular dados vinculados a imagens. Ela é voltada para desenvolvimento de backend e automação científica, em cenários em que você precisa da skill omero-integration para lidar com projetos, datasets, imagens, ROIs, anotações, tabelas ou scripts em lote com menos suposições do que um prompt genérico de programação.

Para quem e quais tarefas ela é mais indicada

Use omero-integration se você estiver criando ferramentas para gestão de dados de microscopia, pipelines de screening ou backends de laboratório que precisem de acesso à API do OMERO. O trabalho prático costuma ser um destes: autenticar em um servidor, percorrer a hierarquia do OMERO, extrair dados de pixels, anexar metadados ou executar processamento no servidor com IDs de objetos e saídas previsíveis.

Por que vale a pena instalar esta skill

O principal valor do omero-integration é que ele direciona você para padrões específicos do OMERO, em vez de palpites genéricos de Python. Isso importa porque o trabalho com OMERO é limitado por gerenciamento de sessão, tipos de objeto, permissões, contexto de grupo e pela diferença entre acesso a dados no cliente e execução em lote no servidor. A skill é mais útil quando você precisa de orientação de integração repetível, e não apenas de código de exemplo.

Quando é uma boa ou má escolha

É uma ótima opção para automação de OMERO em Python, análise de imagens, fluxos de anotação e screening de alto conteúdo. É uma opção menos adequada se você só precisa de uma consulta pontual, se não estiver usando OMERO, ou se a tarefa for mais de configuração de interface do que de desenvolvimento backend orientado por API.

Como usar a skill omero-integration

Instale e examine os arquivos certos

Instale a skill omero-integration pelo fluxo normal de instalação de skills do diretório e, em seguida, leia primeiro SKILL.md e depois siga para references/connection.md, references/data_access.md, references/image_processing.md, references/metadata.md, references/rois.md, references/tables.md, references/scripts.md e references/advanced.md, conforme necessário. Para decisões de omero-integration install, os arquivos de referência importam mais do que o resumo na raiz, porque eles mostram os padrões exatos de conexão, recuperação e atualização que a skill espera.

Comece por uma tarefa concreta no OMERO

Prompts bons nomeiam o tipo de objeto do OMERO, a operação e o contexto. Por exemplo: “Conecte ao OMERO com BlitzGateway, liste os datasets no grupo 5 e exporte os IDs das imagens com os nomes”, ou “Crie ROIs nas imagens do dataset 42 e adicione uma tag de QC”. Esse nível de especificidade torna o omero-integration usage muito mais confiável do que pedir apenas “ajuda com OMERO”.

Leia os arquivos de fluxo na ordem certa

Para problemas de conexão, leia primeiro references/connection.md. Para navegação e filtragem de objetos, use references/data_access.md. Para pixels e imagens derivadas, vá para references/image_processing.md. Para tags, comentários e anotações do tipo map annotation, use references/metadata.md. Para criação de shapes e vínculo de ROIs, use references/rois.md. Para execução em lote, use references/scripts.md. Essa ordem reduz suposições e ajuda você a alinhar a skill exatamente à camada do OMERO que está sendo alterada.

Forneça entradas que reduzam a ambiguidade do OMERO

Um bom prompt de guia para omero-integration deve incluir host do servidor, estilo de autenticação, IDs dos objetos, profundidade da hierarquia e destino da saída. Exemplo: “Usando uma sessão existente, busque a Image 123, obtenha o primeiro plano Z do channel 1 e retorne o shape do NumPy junto com min/max.” Se você omitir o escopo do objeto ou o contexto do grupo, o assistente pode gerar código que funciona sintaticamente, mas falha por permissões do OMERO ou por estar apontando para o contêiner errado.

Perguntas frequentes sobre a skill omero-integration

O omero-integration é só para trabalho com a API Python do OMERO?

Em geral, sim. A skill é centrada em fluxos de trabalho Python do OMERO, como BlitzGateway, recuperação de objetos, tratamento de ROIs, anotações e execução de scripts. Se a sua tarefa estiver fora do OMERO ou não envolver operações de dados em nível de API, um prompt genérico de Python normalmente já resolve.

Preciso ser especialista para usar?

Não. A skill omero-integration é útil para iniciantes que precisam de um padrão inicial confiável, mas você ainda precisa saber qual objeto quer e onde ele está no OMERO. Iniciantes costumam ter resultados melhores quando fornecem uma imagem, um dataset ou um objetivo de script específico, em vez de um pedido amplo como “analise meus dados”.

Em que isso é diferente de um prompt comum?

Um prompt comum pode gerar Python plausível, mas omero-integration é melhor quando você precisa de escolhas específicas do OMERO: limpeza de conexão, reuso de sessão, navegação pela hierarquia e os métodos corretos dos objetos da API. Isso reduz a chance de usar o modelo de objeto errado ou de esquecer restrições do lado do servidor.

Quando não devo usar esta skill?

Não recorra a omero-integration se você só precisa de um passo a passo da interface, se seus dados não estão no OMERO ou se você não consegue fornecer contexto suficiente para identificar a hierarquia de objetos. Ela também não é a melhor escolha se a tarefa for puramente processamento local de imagens, sem integração com o OMERO.

Como melhorar a skill omero-integration

Forneça o menor escopo válido no OMERO

Os melhores resultados com omero-integration vêm de um escopo enxuto: um servidor, um contexto de usuário, um tipo de objeto e uma saída esperada. Diga “dataset 88 no grupo 3” em vez de “todos os meus datasets” e especifique se você quer nomes, IDs, matrizes de pixels, shapes de ROI ou anotações anexadas. Isso melhora muito a relevância e evita código amplo demais.

Declare as restrições que afetam a implementação

Mencione se você pode usar uma sessão existente, se a conexão precisa ser segura, se a tarefa deve rodar localmente ou como um script do OMERO e se você precisa de acesso somente leitura ou com escrita. Esses detalhes mudam o caminho de implementação mais do que a formulação cosmética do prompt.

Peça exatamente o formato de saída de que você precisa

Se você quer código reutilizável, diga isso. Se precisa de um script pontual, peça isso. Se quer omero-integration for Backend Development, solicite funções, tratamento de erros e limpeza de recursos. Se precisa gravar os resultados da análise de volta no OMERO, especifique o tipo de annotation ou o formato da table para que a primeira resposta já venha operacional, e não apenas ilustrativa.

Evolua da conexão para os dados e depois para o writeback

Um fluxo de trabalho forte é: conectar com sucesso, verificar a consulta de objetos, inspecionar campos da imagem ou de metadados e, só então, adicionar writeback de ROI, annotation ou table. Se a primeira saída falhar, refine incluindo o tipo de objeto que falhou, o contexto do grupo ou a chamada de método, em vez de pedir uma reescrita do zero.