Automação do Google Agenda

Quando Usar

• Inspecionar agendas, horários e detalhes de eventos através de uma integração já configurada.
• Rascunhar ou realizar criação, edições, cancelamentos de eventos explicitamente autorizados ou respostas a convites.
• Encontrar possíveis horários livres usando apenas a disponibilidade à qual a conta autenticada pode acessar.

Pré-requisitos e Limitações

Esta habilidade fornece apenas instruções: nenhum helper OAuth, cliente Python, servidor ou armazenamento de tokens é incluído. Descubra o conector autenticado disponível ou o cliente de Agenda de propriedade do projeto e inspecione seu esquema de ferramenta real. Não assuma um tipo de conta específico, comando, fluxo de autenticação, sinalizador de notificação ou atualização automática de token. Se nenhuma integração estiver configurada, forneça um rascunho e explique a configuração ausente; não invente comandos nem busque um script externo em movimento.

Autentique através do fluxo de consentimento existente da integração quando autorizado separadamente. Nunca solicite ou repita senhas, cookies, segredos OAuth ou valores de token no chat. Use as permissões mínimas necessárias. Não inspecione agendas fora do escopo da tarefa nem copie detalhes de participantes para serviços não relacionados.

Fluxo de Trabalho

1. Confirme a conta, o ID da agenda, a janela de data solicitada, o fuso horário IANA e a operação. Resolva datas relativas ambíguas e alterações de horário de verão antes de qualquer escrita.
2. Leia as agendas ou eventos relevantes com resultados limitados. Preserve IDs de eventos, IDs de instâncias de recorrência e informações de fuso horário; distinga eventos de dia inteiro de eventos com horário.
3. Prepare o título proposto, início/fim, descrição, local, participantes e comportamento de notificação. Use apenas campos suportados pela integração real.
4. Para escritas, confirme a autorização para a alteração específica e seus efeitos de notificação. Uma solicitação para inspecionar a disponibilidade não autoriza a criação de um evento nem a notificação de participantes. Mostre o escopo de exclusão e recorrência antes de executar um cancelamento.
5. Execute a operação aprovada uma vez. Em caso de timeout, leia o estado do evento antes de tentar novamente para que um duplicado não seja criado. Não amplie automaticamente o acesso à agenda nem recorra a uma conta diferente.
6. Leia o evento resultante quando permitido. Relate o estado observado, o ID do evento, o fuso horário e se as notificações foram solicitadas. Se o provedor não puder estabelecer a entrega de notificações ou o estado final, declare essa incerteza.

Exemplo

Usuário: "Verifique minha agenda de trabalho para um horário de 30 minutos na próxima terça-feira à tarde em Europa/Roma."

Assistente: Resolva a data de terça-feira, inspecione a disponibilidade permitida da agenda explicitamente selecionada e retorne os horários candidatos. Prepare um rascunho de evento apenas se solicitado. Criar o evento, adicionar participantes ou enviar convites requer autorização para essa ação.

Limitações

• Disponibilidade, escopos, política da conta e capacidades da API dependem da integração configurada.
• A disponibilidade ausente é desconhecida, não prova que um participante está livre.
• Nenhum tempo de execução incluído ou execução real do provedor é implícito pela instalação desta habilidade.
• Não crie, atualize, cancele ou responda a um evento sem autorização correspondente a essa operação.