Overview
Secure storage for passwords, API keys, and tokens.- Stored in YAML files or in-memory dicts
- Never logged or exposed
- Auto-injected as
type_secret
tool - Simple string or dict format
Quick Start
Method 1: In-Memory (Recommended for SDK)
Method 2: YAML File
- Create credentials file:
- Enable in config.yaml:
- Use in code:
How Agents Use Credentials
When credentials are provided, thetype_secret
action is automatically available:
Executor/Manager Mode
CodeAct Mode
Example: Login Automation
- Opens Gmail:
open_app("Gmail")
- Clicks email field:
click(index=3)
- Types email:
type("user@example.com", index=3)
- Clicks password field:
click(index=5)
- Types password securely:
type_secret("EMAIL_PASS", index=5)
- Clicks login:
click(index=7)
Credentials vs Variables
Feature | Credentials | Variables |
---|---|---|
Purpose | Passwords, API keys | Non-sensitive data |
Storage | YAML or in-memory | In-memory only |
Logging | Never logged | May appear in logs |
Access | Via type_secret tool | In shared state |
Security | Protected | No protection |