# Conhecimento, competências e resultados

> Dê a um agente as fontes que deve consultar sempre e as competências que deve carregar primeiro, e escolha o formato das respostas e o destino do seu trabalho.

Por baixo da instrução de um agente, três secções orientam cada execução: **Conhecimento** define o que lê, **Competências** define como sabe realizar o trabalho e **Resultados** define o que devolve.

## Adicionar conhecimento

O conhecimento é aquilo que o agente consulta sempre, como uma lista de preços, um guia de estilo, uma pasta de contratos anteriores ou um site.

1. Abra o agente e aceda a **Conhecimento**.
2. Escreva <kbd>/</kbd> ou escolha **Adicionar recurso** (**+**) e, em seguida, selecione um ficheiro, uma pasta, uma página, uma base de dados ou uma aplicação. Para adicionar um site, escolha **Adicionar site** e cole o respetivo endereço.
3. Para adicionar um ficheiro do seu computador, cole-o no campo. O ficheiro é primeiro adicionado à sua Biblioteca.

O conhecimento aceita ficheiros, pastas, páginas, dados, aplicações e sites, até um total de 20 fontes. Para remover uma fonte, elimine a respetiva etiqueta.

## Adicionar competências

Uma competência ensina Dvina a realizar um tipo de trabalho, como fazer a triagem de um NDA ou elaborar uma proposta. Um agente carrega as suas competências antes de começar.

1. Abra o agente e aceda a **Competências**.
2. Escreva <kbd>/</kbd> ou escolha **Adicionar recurso** (**+**) e, em seguida, selecione uma competência.

Só pode adicionar competências aqui. Um agente pode ter até 10.

## Obter competências

As suas competências encontram-se no seu Feed, em **Competências**. Para obter uma:

- **A partir das competências oficiais:** No seu Feed, escolha **Adicionar contexto** e, em seguida, **Competência a partir de modelo**. Escolha uma competência para ver **Quando Dvina a utiliza**, a respetiva **Licença**, **Origem** e **Ficheiros** e, em seguida, escolha **Adicionar**. É adicionada exatamente como o seu criador a publica, e pode editar a sua cópia.
- **A partir de um ficheiro:** No seu Feed, escolha **Adicionar contexto** e, em seguida, **Competência**, e selecione um ficheiro SKILL.md ou um arquivo de competências (um ficheiro .zip). O arquivo tem de conter uma pasta de competência com um ficheiro SKILL.md e pode incluir várias competências.
- **A partir de uma ligação:** Cole uma ligação para uma competência numa conversa e peça a Dvina para a adicionar. Pode ser um repositório, uma pasta ou um SKILL.md do GitHub, uma página de skills.sh ou uma ligação direta para um ficheiro .zip ou SKILL.md. Dvina pede primeiro a sua aprovação, indicando o nome da competência e a sua origem.

Em qualquer dos casos, confirma uma vez antes de ser adicionado qualquer conteúdo. Dvina mostra a origem da competência e, se esta incluir scripts, quantos são executados no seu ambiente isolado. Uma competência de skills.sh cujo editor não seja oficial é identificada com: **Provém de um editor da comunidade, não de um editor oficial.** Quando a competência de um ficheiro tem o mesmo nome que uma das suas, Dvina indica que irá substituir a sua.

Uma competência cujo SKILL.md não tenha nome ou descrição nos metadados iniciais fica inativa até os adicionar. Para alterar uma competência, abra-a no seu Feed e edite os respetivos ficheiros.

## Escolher os resultados

Em **Resultados**, escolha o formato do trabalho do agente e onde é guardado.

- **Formato da resposta:** Um modelo que todas as respostas seguem, como "Veredito, Riscos, Próximo passo". Descreva-o em linguagem simples.
- **Escrever em:** Um documento ou uma página que é atualizado em cada execução. Escreva <kbd>/</kbd> para o selecionar. Cada execução guarda uma nova versão, e as anteriores permanecem no histórico. Um agente escreve num único documento ou página de cada vez: se selecionar outro, este substitui o anterior.

## Dicas

- **Indique a fonte de referência.** Adicione o ficheiro que o agente deve seguir, como o seu manual de contratos, em vez de o explicar na instrução.
- **Mantenha um único documento atualizado.** Use **Escrever em** para trabalhos que vão sendo acrescentados, como um relatório semanal, para que todas as versões fiquem no mesmo lugar.
- **Os agentes partilhados mostram as suas fontes.** As pessoas com quem partilha um agente veem os conhecimentos, as competências e os resultados do agente no respetivo painel. Uma fonte que não possam abrir aparece como **Sem acesso**.

## Relacionado

- [Criar um agente](/docs/use-dvina/agents/create-an-agent)
- [Contexto](/docs/use-dvina/features/context)
- [Criar](/docs/use-dvina/features/create)
- [Visão geral dos conectores](/docs/connectors/overview)
