Agentes de IA
Os agentes de IA permitem que equipes salvem uma configuração para trabalho recorrente, manual, agendado ou acionado externamente. Crie o agente uma vez, escolha seu ambiente e suas ferramentas e, depois, revise o trabalho e a sessão criados.
Caminho rápido
- Abra Agents e selecione Create agent.
- Preencha Base com o nome do agente, o agente de programação, o provedor de IA e o modelo.
- Use Prompt para adicionar o prompt de sistema, as skills gerenciadas e os plugins.
- Use MCP para selecionar conectores gerenciados quando o agente precisar de ferramentas externas.
- Escolha um acionador em Trigger e selecione Create agent.
Configurar o agente
O assistente tem quatro etapas:
| Etapa | Resultado |
|---|---|
| Base | Define o escopo do projeto ou espaço de trabalho, o agente de programação, o provedor de IA, o modelo, o nível de raciocínio e o acesso opcional ao navegador. |
| Prompt | Define o prompt de sistema e seleciona skills e plugins gerenciados. |
| MCP | Seleciona conectores MCP privados e gerenciados para este agente. |
| Trigger | Cria um agente sob demanda, agendado ou acionado por webhook. |
Um agente pode usar um espaço de trabalho vazio ou o repositório principal do espaço de trabalho quando não estiver vinculado a um único projeto.
Escolher como ele é executado
| Acionador | Use quando |
|---|---|
| Manual | Uma pessoa deve iniciar cada trabalho com Run Now. |
| Agendado | O agente deve ser executado em uma janela de tempo ou a partir de uma expressão cron. |
| Webhook | Um sistema externo deve iniciar o trabalho por meio de uma URL pública. |
Agentes manuais são executados sob demanda. Agentes agendados exigem uma janela de tempo válida ou uma configuração cron. Agentes de webhook usam sua URL de entrada em vez do agendador.
Consulte Webhooks de agentes para conhecer o endpoint público, o corpo POST, as credenciais e o contrato de idempotência.
Adicionar capacidades
- Skills fornecem instruções gerenciadas por catálogo.
- Plugins e marketplaces adicionam instruções de prompt ou pacotes compatíveis de runtime.
- Conectores MCP gerenciados fornecem ao agente as ferramentas MCP remotas selecionadas, mantendo os segredos no servidor.
- Armazenamento privado fornece arquivos privados pela interface, REST e ferramentas MCP.
Cada capacidade selecionada é registrada para o trabalho. Altere a configuração do agente antes de criar o próximo trabalho quando precisar de ferramentas ou instruções diferentes.
Revisar trabalhos e sessões
Cada execução cria um trabalho. Os trabalhos passam pelos estados na fila, em execução, concluído, com falha, cancelado ou aguardando entrada. Abra a sessão para inspecionar o ambiente, a transcrição, a atividade de recursos, as perguntas pendentes e qualquer resultado estruturado validado.
Consulte Sessões e resultados para conhecer o fluxo de revisão da sessão e o comportamento de exibição.
Provedores e acesso
O ambiente de programação, o provedor de IA e o modelo são selecionados de forma independente quando o ambiente escolhido aceita mais de um provedor. As combinações disponíveis são validadas ao salvar um agente. Consulte Provedores e ambientes para conhecer as combinações compatíveis e os requisitos de configuração.