Ferramentas nativas
Além da API Externa, a MarIA traz ferramentas prontas que não exigem nenhum sistema do outro lado.
Pesquisa Web
Seção intitulada “Pesquisa Web”Permite que o agente busque informação pública e atual, com as fontes citadas.
| Campo | O que faz |
|---|---|
| Tamanho do contexto de busca | Baixo (rápido), Médio (equilibrado) ou Alto (mais lento e detalhado) |
| Tipos de conteúdo | Se a busca também deve retornar Imagens |
| Exibir fontes da pesquisa | Liga ou desliga a citação das fontes |
| Modo de exibição | Inline (links no meio do texto) ou Rodapé (lista ao final) |
| Avançado | Localização dos resultados e curadoria de fontes, com listas de sites permitidos e bloqueados |
Esta ferramenta não tem nome nem descrição próprios: ela é nativa do provedor.
Geração de imagens
Seção intitulada “Geração de imagens”Cria imagens a partir da conversa. Útil em cenários de ilustração e prototipagem; evite em fluxos onde a pessoa possa confundir a imagem gerada com uma foto real do produto.
| Tipo | Uso |
|---|---|
| Generic Card | Conteúdo estruturado renderizado dentro do chat |
| HTML Card | Um bloco HTML próprio, para layouts específicos |
| Cards Externos | Renderização fora da janela do chat, em layout ou modal |
Cards deixam a resposta legível quando há muitos dados — uma lista de pedidos, por exemplo, funciona muito melhor em card do que em texto corrido.
Coleta dados estruturados durante a conversa, com campos definidos por você. É a forma correta de pedir várias informações de uma vez, em vez de arrancá-las uma a uma no meio do diálogo.
Exibe pontos no mapa e permite interagir com eles — lojas próximas, pontos de coleta, endereços de entrega.
Sub Agent
Seção intitulada “Sub Agent”Delega parte do trabalho a outro agente da solução, que devolve o resultado ao agente principal. Difere do especialista por reutilizar um agente completo, com suas próprias ferramentas e arquivos.
Ferramentas de mídia e arquivo
Seção intitulada “Ferramentas de mídia e arquivo”| Ferramenta | O que faz |
|---|---|
| Enviar Texto | Envia um trecho de texto pronto, com placeholders @@nome@@ para valores dinâmicos |
| Enviar Arquivo | Entrega um arquivo à pessoa dentro da conversa |
| Resolver Conteúdo de Arquivo | Lê o conteúdo de um arquivo enviado na conversa para o agente usar |
Enviar Texto é útil para mensagens que precisam sair sempre iguais — aviso legal, resumo de pedido, instruções de troca — sem depender de o modelo reescrever o texto a cada vez.
Resumo da configuração
Seção intitulada “Resumo da configuração”Quase todos os formulários trazem, no rodapé, um Resumo da configuração com o que será gravado. É a forma mais rápida de conferir antes de salvar.