# Agentes O Nimbly Agent integrado e o framework para seus próprios agentes. O Nimbly inclui o **Nimbly Agent**, um assistente que entende o framework e o site atual, e um **framework de agentes** para agentes do próprio projeto. São recursos da aplicação: os agentes podem participar de conversas e executar fluxos de trabalho definidos pela mesma plataforma que o resto do seu sistema. ## Nimbly Agent O agente integrado ajuda usuários autorizados a encontrar informações, navegar pela aplicação e trabalhar com conteúdo. Suas ferramentas podem ler recursos e a documentação do site, e criar, alterar ou excluir registros dentro das permissões do usuário que pede. O contexto do site pode ser acrescentado em `ext/agents/nimbly/project.md`. Isso complementa as instruções integradas, enquanto as atualizações do framework continuam fornecendo a definição de base do agente. ## Disponibilize aos usuários O assistente integrado precisa da configuração do provedor de modelo indicada na sua definição, atualmente `OPENAI_API_KEY` no `.env` de runtime. Mantenha essa credencial fora dos arquivos versionados. O chat e o agente precisam estar ativados nas configurações do site, e a função do usuário precisa conceder `chat-nimbly`. Um agente de chat fica disponível quando as configurações de ambiente exigidas, as chaves do site e a permissão da função estão todas presentes. O layout HTML do core inclui o botão do chat da equipe para os usuários autenticados que têm acesso. Essas condições de acesso são separadas das permissões para operações com dados. Dar a um usuário acesso ao chat não dá permissão para editar um recurso. ## Defina um agente especializado Um agente do projeto fica em `ext/agents//`. O `agent.json` dele define identidade, instruções, ferramentas, limites de execução e pipelines. A definição integrada em `core/modules/agent/agents/nimbly/agent.json` serve de referência para um agente de chat. - Uma `chat_pipeline` torna um agente disponível no chat da equipe. - Uma `pipeline` define trabalho em fila, agendado ou disparado por eventos. - Os conectores do projeto em `ext/lib/agent-connector-.php` fornecem o comportamento de integração usado pelas ferramentas e pelos passos da pipeline. Uma definição do projeto com a mesma identidade substitui a definição do core. Acrescente contexto do site quando isso bastar; substitua a definição quando o comportamento precisar ser diferente. ## Ferramentas, execução e autorização Os agentes usam ferramentas e conectores declarados. Ações controladas têm uma etapa de autorização antes da execução. As ferramentas de conteúdo do Nimbly Agent agem com as permissões do usuário que pede. Um agente próprio deve definir a autorização adequada às operações que realmente faz, em vez de supor que ter acesso a uma conversa dá permissão para executar algo. O framework registra execuções, passos, eventos e ações, para que se possa ver o que rodou e com que resultado. A execução em fila e agendada usa a base existente de jobs e agendamento. O projeto define sua lógica de negócio, ferramentas, agendas e limites de operação. Por exemplo, um site de estúdio pode acrescentar um assistente que responde a perguntas sobre os projetos, ou um fluxo agendado que prepara um resumo semanal. O projeto implementa as ferramentas, as permissões e a entrega correspondentes. ## Leia a seguir - [Usuários e permissões](/pt/docs/guides/permissions/) - [Trabalho em segundo plano](/pt/docs/guides/jobs/) - [Integrações](/pt/docs/guides/integrations/) - [Trabalhando com agentes de programação com IA](/pt/docs/learn/for-ai-agents/) trata de agentes de programação que trabalham num projeto Nimbly, que é outro assunto.