Desenvolver aApps

Se pretende criar ou personalizar aApps, siga esta abordagem:

1. Defina primeiro as capacidades e só depois crie a interface

   1. Comece por definir o problema, os utilizadores-alvo e o resultado esperado.

   2. Crie ações semânticas (para invocação pelo Agent) antes de desenvolver a interface.

   3. Evite criar demasiadas páginas e botões numa fase inicial, pois isso aumenta a complexidade e reduz a composibilidade.

2. Crie interfaces adequadas para Agent

   1. Use nomes claros e orientados para a ação.

   2. Mantenha os parâmetros concisos e consistentes.

   3. Crie tendo em conta a composibilidade, para que os fluxos de trabalho com várias etapas possam ser encadeados de forma fiável.

3. Crie primeiro um ciclo mínimo viável

   Dê prioridade primeiro a este ciclo de base:

   Pedido do utilizador → O Agent chama uma aApp → A aApp devolve um resultado utilizável

   Quando este ciclo estiver estável, expanda-o com capacidades avançadas, como subscrições, automatização e uma interface mais completa.

4. Separe a recuperação de informação da resposta

   1. Use capacidades orientadas para a recuperação quando precisar de candidatos estruturados (IDs, metadados e resultados processáveis por máquina).

   2. Use capacidades orientadas para a resposta quando precisar de respostas diretas para os utilizadores.

   3. Esta separação melhora a fiabilidade, a interpretabilidade e o desempenho.

5. Crie a automatização de eventos como um pipeline completo

   Uma subscrição não é apenas um acionador. Um fluxo robusto deve incluir:

   Condição de acionamento → Enriquecimento do contexto → Análise/processamento → Registo de resultados/feedback

   Isto garante que a automatização proporciona valor de forma consistente, em vez de se limitar a «acionar eventos».

Design de remio pensado para programadores

1. Isolamento dos ambientes DEV / PROD

   1. DEV destina-se ao desenvolvimento, à depuração e aos testes.

   2. PROD destina-se a uma utilização diária estável.

   3. O código e os dados estão isolados, para que os testes não afetem a utilização em produção.

2. Mudança visual de ambiente

   1. O estado DEV/PROD está visível na navegação e pode ser alterado facilmente.

   2. Isto permite um desenvolvimento iterativo e seguro.

3. Dois pontos de entrada: Skill Market + Skill Studio

   1. Skill Market: descubra, instale e faça a gestão dos Skills disponíveis.

   2. Skill Studio: clone, modifique e publique Skills para teste.

   3. «Usar» e «criar» estão claramente separados, reduzindo o custo de adoção.

4. Integração MCP: acesso simples + elevada flexibilidade

   1. Suporta uma integração rápida baseada em OAuth e a configuração manual (stdio / streamable-http).

   2. Adequa-se tanto a uma adoção rápida como a cenários de integração avançada.

Dicas para programadores

• Faça uma validação completa em DEV antes de mudar para PROD.

• Introduza uma dependência externa de cada vez (por exemplo, um servidor MCP) para facilitar a resolução de problemas.

• Reutilize primeiro os Skills/aApps existentes e depois personalize-os de forma incremental.

• Em todos os fluxos automatizados, adicione uma alternativa em caso de falha e feedback visível para o utilizador.