> ## Documentation Index
> Fetch the complete documentation index at: https://symphony-docs.fcamara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes

> Crie, edite e compartilhe assistentes de IA configurados para uma finalidade específica.

## O que é

Um **agente** é um assistente de IA configurado para uma finalidade específica. Você define o **modelo base**, as **instruções** (como ele deve se comportar), o **conhecimento** que ele consulta, sugestões de prompts, **parâmetros avançados** e **ferramentas**. Depois, é só conversar com ele no chat — e, se quiser, **compartilhá‑lo** com colegas.

## Como acessar

* Barra lateral → **Agentes**
* Para criar: botão **Novo → Agente** (no topo) ou o botão de criação na página de Agentes.

<Note>
  A página de Agentes só aparece se o módulo **Workspace** e a permissão de **Agentes** estiverem habilitados para você.
</Note>

## Galeria de Agentes

Você pode visualizar **todos os agentes criados pelo time Symphony** na galeria pública e **solicitar acesso** aos que precisar:

<Card title="Abrir a Galeria de Agentes" icon="grid-2" href="https://symphony.fcamara.com/agents-gallery">
  Explore o catálogo de agentes por área em **symphony.fcamara.com/agents-gallery** e solicite o acesso aos agentes desejados.
</Card>

## Criar um agente

Na tela **Criar agente**, preencha os blocos a seguir:

<AccordionGroup>
  <Accordion title="1. Informações do agente" icon="id-card">
    * **Nome** *(obrigatório)* — como o agente será exibido.
    * **Modelo base** *(obrigatório)* — o modelo de IA que dá "inteligência" ao agente. Sem ele, não é possível salvar.
    * **Descrição** — breve resumo do que o agente faz.
    * **Imagem/avatar** — foto do agente. Aceita **PNG ou JPG de até 5 MB**.
    * **ID** *(obrigatório na criação)* — identificador único do agente. Não pode repetir um ID já existente.
  </Accordion>

  <Accordion title="2. Instruções" icon="list-check">
    Campo de **prompt do agente**: descreva o papel, o objetivo, o tom de voz, o formato de resposta e as regras que o agente deve seguir. É o que mais influencia o comportamento dele. Há um link **"Saiba mais"** com orientações.
  </Accordion>

  <Accordion title="3. Conhecimento" icon="book">
    Conecte uma ou mais **bases de conhecimento** (criadas na página [Conhecimento](/guia/base-conhecimento)) para que o agente use esses documentos como referência. Você também pode criar uma nova base sem sair da tela.
  </Accordion>

  <Accordion title="4. Sugestões de prompt (opcional)" icon="lightbulb">
    Adicione exemplos de perguntas/comandos que aparecerão como sugestões para quem for usar o agente.
  </Accordion>

  <Accordion title="5. Parâmetros avançados (opcional)" icon="sliders">
    Bloco recolhível para ajustar o comportamento do modelo (por exemplo, criatividade/temperatura e outros parâmetros). Inclui também:

    * **Seleção de ferramentas** — quais [ferramentas](/guia/ferramentas) o agente pode usar.
    * **Capacidades** *(apenas administradores)* — como visão (imagens), uso e citações.
    * **Pré‑visualização JSON** — mostra a configuração final do agente em formato técnico.
  </Accordion>
</AccordionGroup>

Ao terminar, clique em **Salvar**. Uma mensagem confirma **"Agente criado com sucesso!"** e você volta à lista.

## Editar um agente

Na lista de agentes, abra um agente existente para **editar**. Os mesmos blocos da criação ficam disponíveis. Alterações são confirmadas com **"Agente atualizado com sucesso!"**.

## Compartilhar um agente

No editor do agente, use **Compartilhar**. Defina o **controle de acesso** — quais **usuários** e **grupos** podem **visualizar/usar** ("Pode conversar") e quem pode **editar**.

<Warning>
  Antes de compartilhar, os campos obrigatórios (nome, modelo base e ID) precisam estar preenchidos.
</Warning>

## Boas práticas

* Escreva **instruções claras e objetivas**: defina papel, objetivo, tom e o que o agente **não** deve fazer.
* Conecte **bases de conhecimento** relevantes para respostas alinhadas ao seu contexto.
* Dê um **nome e descrição** que deixem claro o propósito do agente para quem for usá‑lo.
* Use **sugestões de prompt** para orientar os usuários menos experientes.
* Comece com poucos **parâmetros avançados**; ajuste só se necessário.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Preciso saber programar para criar um agente?">
    Não. Criar agentes é feito por formulário. Programação só é necessária para criar **ferramentas** (veja [Ferramentas](/guia/ferramentas)).
  </Accordion>

  <Accordion title="Por que não consigo salvar?">
    Verifique se preencheu **Nome**, **Modelo base** e **ID**. O ID precisa ser único — se já existir, escolha outro.
  </Accordion>

  <Accordion title="Quem pode ver o agente que criei?">
    Apenas você, até compartilhá‑lo. No compartilhamento você escolhe usuários e grupos.
  </Accordion>

  <Accordion title="Onde uso o agente depois de criado?">
    No chat, pelo **seletor de modelo** no topo da conversa, ou digitando `@` na mensagem.
  </Accordion>
</AccordionGroup>

## Limitações conhecidas

* Todo agente exige um **modelo base** — não é possível salvar sem ele.
* A imagem do avatar é limitada a **5 MB** (PNG/JPG).
* O campo **Capacidades** é editável apenas por **administradores**.
* A lista de modelos base disponíveis depende das **conexões/modelos** configurados pelo administrador; modelos ocultados pela empresa não aparecem.
* A criação/edição de agentes depende da permissão de **Agentes** no Workspace.