Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license
This commit is contained in:
@@ -0,0 +1,104 @@
|
||||
---
|
||||
title: "Agentmail — Use when an agent needs AgentMail CLI email inboxes"
|
||||
sidebar_label: "Agentmail"
|
||||
description: "Use when an agent needs AgentMail CLI email inboxes"
|
||||
---
|
||||
|
||||
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
|
||||
|
||||
# Agentmail
|
||||
|
||||
Use when an agent needs AgentMail CLI email inboxes.
|
||||
|
||||
## Skill metadata
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| Source | Optional — install with `hermes skills install official/email/agentmail` |
|
||||
| Path | `optional-skills/email\agentmail` |
|
||||
| Version | `1.0.0` |
|
||||
| Author | Haakam Aujla (Haakam21), AgentMail |
|
||||
| License | MIT |
|
||||
| Platforms | linux, macos, windows |
|
||||
| Tags | `Email`, `CLI`, `AgentMail`, `Communication` |
|
||||
|
||||
## Reference: full SKILL.md
|
||||
|
||||
:::info
|
||||
The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
|
||||
:::
|
||||
|
||||
# AgentMail Skill
|
||||
|
||||
AgentMail gives an agent its own email inbox for sending mail, receiving
|
||||
replies, completing email OTP flows, and running inbound email loops. Use it for
|
||||
agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.
|
||||
|
||||
Use the `agentmail` CLI first. Use MCP only when the harness expects MCP tools;
|
||||
use REST only when the CLI is missing a required operation.
|
||||
|
||||
## When to Use
|
||||
|
||||
- The agent needs an email address it owns.
|
||||
- The task involves email OTP flows, replies, threads, labels, or attachments.
|
||||
- The agent needs webhook or WebSocket delivery for inbound mail.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Run commands through the `terminal` tool.
|
||||
- Install the CLI:
|
||||
|
||||
```bash
|
||||
npm install -g agentmail-cli@latest
|
||||
```
|
||||
|
||||
- Export an API key:
|
||||
|
||||
```bash
|
||||
export AGENTMAIL_API_KEY="am_..."
|
||||
```
|
||||
|
||||
No API key yet? Use [signup.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/signup.md).
|
||||
|
||||
## How to Run
|
||||
|
||||
Use `--format json` whenever another command or script needs IDs.
|
||||
|
||||
```bash
|
||||
agentmail inboxes list --format json
|
||||
```
|
||||
|
||||
## Quick Reference
|
||||
|
||||
- [AgentMail agent reference](https://agentmail.md): hosted copy.
|
||||
- [AgentMail](https://agentmail.to): product landing page.
|
||||
- [Console](https://console.agentmail.to): API keys and account management.
|
||||
- [Docs](https://docs.agentmail.to): full product documentation.
|
||||
- [signup.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/signup.md): self-signup and OTP verification.
|
||||
- [core.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/core.md): inboxes, messages, threads, labels, attachments.
|
||||
- [webhooks.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/webhooks.md): events to a public HTTPS server.
|
||||
- [websockets.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/websockets.md): events to a local agent process.
|
||||
- [mcp.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/mcp.md): MCP integration.
|
||||
|
||||
## Procedure
|
||||
|
||||
1. Install `agentmail-cli@latest` and verify `agentmail inboxes list --format json`.
|
||||
2. If no API key is available, complete [signup.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/signup.md).
|
||||
3. Use [core.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/core.md) for inbox, send, read, reply, forward,
|
||||
label, thread, and attachment flows.
|
||||
4. Add [webhooks.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/webhooks.md) or
|
||||
[websockets.md](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/email\agentmail/references/websockets.md) only when polling is not enough.
|
||||
|
||||
## Pitfalls
|
||||
|
||||
- Prefer `AGENTMAIL_API_KEY` over `--api-key`.
|
||||
- Never expose `AGENTMAIL_API_KEY` in prompts, logs, URLs, or committed files.
|
||||
- Use stable `client_id` values for retried create operations.
|
||||
- Prefer `extracted_text` or `extracted_html` for LLM input when present.
|
||||
- React to `message.received`, not messages the agent sent.
|
||||
|
||||
## Verification
|
||||
|
||||
```bash
|
||||
agentmail inboxes list --format json
|
||||
```
|
||||
Reference in New Issue
Block a user